^ Texas Instruments 

Improving Man's Effectiveness Tfirough Electronics 






r 



Model 990 Computer 
Terminal Executive Develooment System 

(TXDS) 

Programmer's Guide 



MANUAL NO. 946258-9701 

ORIGINAL ISSUE 1 APRIL 1977 

INCLUDES 

CHANGE 1 1 JULY 1977 

CHANGE 2 15 OCTOBER 1977 

CHANGE 3 15 DECEMBER 1977 



r 



Digital Systems Division 




(c) Texas Instruments Incorporated 1977 
An Rights Reserved 

The Information and/or drawings set forth in this docufnent and all rights In and 
to Inventions disclosed herein and patents which might be granted thereon disclos- 
ing or employing the materials, methods, techniques or apparatus described herein 
are the exclusive property of Texas Instruments Incorporated. 
No disclosure of the information or drawings shall be made to any other person or 
organization without the prior consent of Texas Instruments Incorporated. 



^ 



LIST OF EFFECTIVE PAGES 



INSERT LATEST CHANGED PAGES DESTROY SUPERSEDED PAGES 



Note: The portion of the text affected by the changes Is 
indicated by a vertical bar In the outer margins of 
the page. 



Model 990 Computer Terminal Development System (TXDS) 
Programmer's Guide (946258-9701) 

Original Issue 15 April 1977 

Change 1 ^ July 1977 (ECN 419567) 

Change 2 15 October 1977 (ECN 419599) 

Change 3 15 December 1977 (ECN 41 5098) 



Total number of pages in this publication is 220 consisting of the following: 



PAGE CHANGE 

NO. NO. 

Cover 3 

Effective Pages 3 

iii -ix 3 

X 1 

xi- xii 3 

1-1 -1-2 3 

1-3 

14 3 

2-1 -2-12 3 

3-1 -3-3 3 

34 

3-5 3 

3-6 

4-1-4-2 3 

4-3-44 1 

4-5-4-6 

4-7 1 

4-8 2 

4-9-4-10 1 

4-11 -4-12 2 

4-13 

4-14 2 

4-15 

4-16 3 

4-17-4-18 1 



PAGE CHANGE 

NO, NO. 

4-19-4-22 

4-23 2 

4-24 

5-1 -5-6 3 

6-1 -6-3 

64 3 

7-1 - 7-2 3 

74 1 

74 1 

7-5 - 7-6 

7-7 3 

7-8 1 

8-1 3 

8-2 

8-3 - 84 3 

9-1 2 

9-2 - 9-2B 3 

9-3 

94 2 

9-5 

9-6 2 

9-8-9-8B 1 

9-9 2 

9-10-9-23 

9-24 2 



PAGE CHANGE 

NO. NO. 

9-25 - 9-34 

9-35-9-36B 1 

9-37-946 

10-1 2 

10-2-10-3 1 

104-10-6 3 

10-7 2 

10-8 3 

10-9-10-10 2 

10-11 1 

10-12-10-13 2 

10-14 1 

10-15 2 

10-16-10-18 1 

10-19 2 

10-20 1 

10-21 1 

10-22 2 

10-23-10-26 1 

11-1 - 11-2 1 

11-3 3 

114 1 

11-5 -11-68 3 

11-7 3 

11-8 1 



(C) Texas Instruments Incorporated 1977 
All Rights Reserved 

The Information and/or drawings set forth in this document and all rights In and 
to Inventions disclosed herein and patents which might be granted thereon disclos- 
ing or employing the materials, methods, techniques or apparatus described herein 
are the exclusive property of Texas Instruments Incorporated. 

No disclosure of the information or drawings shall be made to any other person or 
organization without the prior consent of Texas Instruments Incorporated. 



ilPPPlKy 



LIST OF EFFECTIVE PAGES 



INSERT LATEST CHANGED PAGES DESTROY SUPERSEDED PAGES 



Note: The portion of the text affected by the changes Is 
Indicated by a vertical bar In the outer margins of 
the page. 



Model 990 Computer Terminal Development System (TXDS) 
Programmer's Guide (946258-9701) (Continued) 



Total number of pages in this publication is 



consisting of the following: 



PAGE CHANGE 

NO . NO. 

11-9 3 

11-10-1M4 1 

12-1 3 

I2'2 . . 

12-3 3 

12-6 

13-1-13-2 3 

Appendix A I)iv 

A-1 - A4 

Appendix B Div 

B-l-B-2 2 



PAGE CHANGE 

NO, NO. 

Appendix C Div 

C-1 -C-2 

Appendix D Div 

D-1 3 

D-2 

Alphabetical Index Div. . . .0 

Index-1 - lndex-6 3 

User's Response 3 

Business Reply 

Cover Blank 

Cover 



PAGE 
NO. 



CHANGE 
NO. 



liA/iiB 



/-^*^ 




946258-9701 



PREFACE 

This manual enables the user to employ the Terminal Executive Development System (TXDS) in 
conjunction with the TX990 Operating System and the Model 990/4 and 990/10 Computer System 
hardware configuration to develop, improve, change, or maintain (1) the user's customized 
Operating System and the user's applications programs or (2) any other type of user-produced 
programs (e.g., the user's own supervisor call processors or the user's own utility programs). It is 
assumed the reader is famiUar with the Model 990 Computer System assembly language and the 
concepts of the TX990 Operating System. 

The sections and appendixes of this manual are organized as follows: 

I Introduction - Provides a general description of the TXDS utility programs and their 
capabilities. Also includes a description of the control functions of the TXDS Control 
Program. 

II Loading and Executing a Program — Provides a step-by-step procedure for loading and 
executing (1) each of the TXDS and TX990 Operating System utility programs and (2) a 
user program. Also describes the TXDS Control Program and how to correctly respond to 
its prompts. 

III Verification of Operation — Provides several short step-by-step procedures to checkout 
proper operation of the TXDS software. 

IV Creating and Editing Program Source Code - Describes the capabilities of the TXEDIT I 
utiHty program and how the user can employ those capabilities to edit or generate the 
text of source programs and object programs. 

V Assembling Source Programs - Describes how the user can employ the TXMIRA utility | 
program to assemble source files (i.e., source code programs). 

VI TX990 Cross Reference (TXXREF) Utility Program - Describes how the user can 
employ the TXXREF utility program to produce a listing of each user-defined symbol 
in a 990 assembly source program along with the line numbers on which the symbol is 
defined and all of the line numbers on which the symbol is referenced. 

VII Linking Object Modules - Describes how the user can employ the TXDS Linker utility | 
program to form a single object module from a set of independently assembled object 
modules (in the form of object code or compressed object code). 

VIII TXDS Copy Concatenate (TXCCAT) Utility Program - Describes how the user can 
employ the TXCCAT utility program to copy one to three files to a single output file. 

IX TXDS Standalone Debug Monitor (TXDBUG) Utility Program - Describes how the user 
can employ the TXDBUG utility program to debug programs which have been designed 
to operate in a "standalone" situation without support of an operating system. 

X TXDS PROM (TXPROM) Programmer Utility Program - Describes how the user can 
employ the TXPROM programming utility program to control the Programming Module 
(PROM) hardware to make customized ROMs containing user-created data or programs. 
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XI TXDS BNPF/High Low (BNPFHL) Dump Utility Program - Describes how the user can 
employ the BNPFHL utility program to produce a BNPF or high/low file format. 

XII TXDS IBM Diskette Conversion Utility (IBMUTL) Program - Describes how the user can 
employ the IBMUTL utility program to transfer standard IBM-formatted diskette datasets 
to TX990 Operating System files and to transfer TX990 Operating System files to 
standard IBM-formatted diskette datasets. 

XIII TXDS Assign and Release LUNO Utility Program - Describes how the operator can 
assign and release LUNOs in systems which do not include OCP. 

A Glossary - Clarifies selected words used in this TX990 Operating System Programmer's 
Guide. 

B Compressed Object Code Format - Describes the compressed object code format. 

C Task State Codes — Lists and describes the task state codes. 

D I/O Error Codes — List and describes the I/O error codes available to the user, when 
coding a program, for printout or display on a terminal device. 

The following documents contain additional information related to the TX990 Operating System 
and are referenced herein this manual: 
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Title Part Number 

Model 990 Computer TX990 Operating System Programmer's 946259-9701 
Guide 

Model 990 Computer TMS9900 Microprocessor Assembly 943441-9701 
Language Programmer's Guide 

Model 990 Computer Model FD800 Floppy Disc System 945253-970 1 
Installation and Operation 

Model 990 Computer Model 913 CRT Display Terminal 943457-970 1 
Installation and Operation 

Model 990 Computer Model 91 1 Video Display Terminal 943423-970 1 
Installation and Operation 

Model 990 Computer Model 733 ASR/KSR Data Terminal 945259-970 1 
Installation and Operation 

Model 990 Computer Model 804 Card Reader Installation 945 262-970 1 
and Operation 

Model 990 Computer Models 306 and 588 Line Printers 94526 1 -970 1 
Installation and Operation 

Model 990 Computer PROM Programming Module 945258-9701 
Installation and Operation 

990 Computer Family Systems Handbook 945250-970 1 

Model 990 Computer Communications System Installation 945409-9701 
and Operation 
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SECTION I 
INTRODUCTION 

- 1.1 GENERAL 

The Tenninal Executive Development System (TXDS) provides an extensive software capability to 
assist in developing, improving, changing, or maintaining (1) the user's customized Operating 
^ System and the user's applications programs or (2) any other type of user-produced programs (e.g., 

the user's own supervisor call processors or the user's own utility programs). Essentially, TXDS 
delivers this capability by means of the following nine utility programs: 

® TXDS Text Editor (TXEDIT) Utility Program 

• TXDS Assembler (TXMIRA) Utility Program 

f^i • TXDS Cross Reference (TXXREF) Utility Program 

• TXDS Linker (TXLINK) Utility Program 
TXDS Copy Concatenate (TXCCAT) Utility Program 
TXDS Standalone Debug Monitor (TXDBUG) Utility Program 
TXDS PROM (TXPROM) Programmer Utility Program 
TXDS BNPF/High Low (BNPFHL) Dump Utility Program 

• TXDS IBM Diskette Conversion Utility (IBMUTL) Program 

• TXDS LUNO (TXLUNO) Utility Program 

Another important feature of TXDS is its capability to function as a control center by means of the 
TXDS Control Program. The TXDS Control Program simplifies operator interaction with the 
computer by (1) informing the operator, for example, when a program has been successfully loaded 
(^ or executed or (2) by requesting the operator for an entry of data/information into the computer 

via the keyboard of the system console (i.e., the 911 or 913 Video Display Terminal, the 
733 ASR/KSR Data Terminal, or the 743 KSR Data Terminal). Basically, the TXDS Control Pro- 
gram functions to prompt (i.e., request) the user for the name of the utility program to load, and 
the input, output, and options parameters required by the utility program. After the parameters 
have been entered via the system console keyboard, by the user, in response to the prompts, the 
specified utility program is loaded into memory and executed. When the utility program has 
completed execution, the TXDS Control Program again prompts the operator for the name of 
another program to load, and for the input, output, and options parameters required by the 
program. 

TXDS can also be used to extend and upgrade the capabilities of the TX990 Operating System. By 
making appropriate use of the TXDS utility programs, users are able to more easily develop, 
improve, change, or maintain their software. TXDS is an ideal supplement to the TX990 Operating 
System software package. 
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The TXDS utility programs are briefly described in the following paragraphs; detailed descriptions 
(including step-by-step loading procedures, descriptions of available commands, and coding '^ 

examples explaining typical employment of each utility program) are provided in the other sections 
in this manual. Figure 1-1 presents the data flow and control paths among the elements of the 
Terminal Executive Development System software; figure 1-2 presents a typical hardware configura- 
tion supporting TXDS capabilities. 

1 .2 TXDS TEXT EDITOR (TXEDIT) UTILITY PROGRAM 

TXEDIT operates interactively with the operator's system console and provides a method of 
modifying existing source code on diskette fiJes or cassettes and of creating new source files. Its ^, 

features include the abihty to make multiple single directional editing passes on the source file to 
add, remove, move, or change lines of source. 

1 .3 TXDS ASSEMBLER (TXMIRA) UTILITY PROGRAM 

TXMIRA is a two-pass assembler that produces object code for any member of the Model 990 
Computer family, including the TMS9900 Microprocessor. The assembler accepts an assembly 
language source program and produces a source Hsting and an object file. For more detailed infor- 
mation, refer to the Model 990 Computer TMS9900 Microprocessor Assembly Language ^ 
Programmer's Guide. 

1 .4 TXDS CROSS REFERENCE (TXXREF) UTILITY PROGRAM 

TXXREF produces a listing of each user-defined label in a 990 assembly source program along with 
the line number on which each label is defined and all of the numbers of the lines from which the 
label was referenced. The program may be invoked by either user directive, via the TXDS Control 
Program, or by chaining to it from the assembler. 

1 .5 TXDS LINKER (TXLINK) UTILITY PROGRAM ..^ 
TXLINK links object modules produced by the assembler to form a single object module. The 1 
linker allows the specification of up to three input files each of which may contain multiple object 
modules. TXLINK can also perform partial Unks which may later be hnked with additional modules 

to complete the linking process. 

1 .6 TXDS COPY CONCATENATE (TXCCAT) UTILITY PROGRAM 

TXXCAT facilitates the transfer of data from file or device to file or device and allows for the 
specification of up to three source or object files to be copied to one output file or device. 

1 .7 TXDS STANDALONE DEBUG MONITOR (TXDBUG) UTILITY PROGRAM ^ 
TXDBUG is a memory-resident, standalone, system executive that provides extensive program 

debug features and responds interactively to user input from a 733 ASR Data Terminal. 

1 .8 TXDS PROM (TXPROM) PROGRAMMER UTILITY PROGRAM 

TXPROM provides flexible user control of the PROM programming process as well as standardized 
programming options. 

1 .9 TXDS BNPF/HIGH LOW (BNPFHL) DUMP UTILITY PROGRAM 

This utihty allows a user to produce a BNPF-formatted file, output the file to an appropriate media 

(paper tape, cassette, etc.) and to compare the media contents to the BNPF-formatted file. It also 

allows a user to produce a TI 256 by 4 high/low-formatted file, output the file to an appropriate " 

media, and compare the media contents to the input file contents. 



1 .10 TXDS IBM DISKETTE CONVERSION UTILITY (IBMUTL) PROGRAM 

This utiUty provides a means of transferring standard IBM-formatted diskette data sets to TX990 
files and transferring TX990 files to standard IBM-formatted diskette data sets. 

1 .1 1 TXDS LUNO (TXLUNO) PROGRAM 

TXLUNO allows the user to assign and release LUNOs without using OCP commands. 
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Figure 1-2. Model FS990/4 Floppy Based Software 
Development System. Minimum Hardware Configuration for TXDS 
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SECTION II 
LOADING AND EXECUTING A PROGRAM 



tf^\ 



^^\ 



i|P™^ 



2.1 INTRODUCTION 

This section provides the user with a simple procedure for executing: (1) each of the TXDS and 
TX990 Operating System utiUty programs; and (2) a user program. Tlie TXDS and TX990 
Operating System utiUty programs are Hsted as follows: 



TX990 Operating System 
UtUity Programs 

System Generation (GENTX) 
Object Manager (OBJMGR) 
Diskette Backup (BACKUP) 
Diskette OCP System Utility (SYSUTL) 
Ust 80-80 (LIST80) 
Diskette Dump (DSKDMP) 



TXDS 
Utility Programs 

Text Editor (TXEDIT) 
Assembler (TXMIRA) 
Cross Reference (TXXREF) 
Linker (TXLINK) 
Copy Concatenate (TXXCAT) 
Standalone Debug (TXDBUG) 
PROM Programmer (TXPROM) 
BNPF/HIGH LOW Dump (BNPFHL) 
IBM Diskette Conversion (IBMUTL) 
LUNO Assignment (TXLUNO) 

The program loading and executing procedure is greatly simplified by the interactive, memory- 
resident TXDS Control Program, which enables loading and executing of any one of the above 
utility programs or a user program. The TXDS Control Program (only one of which is included with 
each Terminal Executive Development System) assists in program loading and execution by printing 
out or displaying prompts (i.e., requests) on the system console, sequentially, as follows: 

PROGRAM 

INPUT 

OUTPUT 

OPTIONS 

The TXDS Control Program also prints out or displays information which indicates to the operator 
that a program has been successfully loaded or is in the process of being executed. For example, 
after the TXDS Control Program is executed, the following printout or display is presented at the 
system console: 

TXDS 936215 ** 152/77 1:05 

PROGRAM: 

The above display tells the operator that the TXDS Control Program is in execution and that the 
operator may respond to the PROGRAM: prompt by specifying the program to be loaded. The 
display heading indicates the name of the monitor (TXDS), the part number of the software, 
the revision status (** = no revision, *A = 1st revision, *B = 2nd revision, etc.), and the date and 
time of day that the program was loaded (152/77 = 152nd day of 1977). 
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The following paragraphs in this section present a procedure for loading and executing a program 

with supplementary supporting information describing: (1) how to correctly respond to the v-=«^ 

prompts; (2) how to use correct syntax; (3) how to use the special keyboard control keys; and ^ 

(4) how to code the COMMON memory block. Also included in this section is a procedure for 

backing up a Tl-supplied TXDS diskette and a description of the TXDS Control Program error 

messages. 

2.2 LOADING AND EXECUTING A PROGRAM 

Proceed as follows: 

1 . Load the Operating System (which has been customized to the user's software/hardware o 
configuration) by performing the steps in Section II, entitled "Loading The Operating 
System", of the TX990 Operating System Programmer's Guide. 

2. Press the exclamation point (!) key on the system console keyboard. 

3. If OCP is included in the system, it responds with a period (.) prompt: 

If OCP is not included, proceed to step 5. 

4. Execute the TXDS Control Program by responding to the period (.) prompt as follows: 

f 
.EX,16.TE. 

5. Observe the following printout or display presented on the system console: ' 

TXDS ** 010/77 2:05 

PROGRAM: 

NOTE 

To correctly respond to the PROGRAM:, INPUT:, OUTPUT:, and 

jOPTIONS: prompts, the operator is required to understand the "^ 

information presented under paragraph 2.3. 

6. Respond to the PROGRAM: prompt in accordance with the parameters defined in 
paragraph 2.3 below by entering the device-name identifier of the input device on which 
the program to be loaded and executed is stored and/or the file-name identifier of the 
program to be loaded and executed. 

7. After responding to the PROGRAM: prompt, the user can enter a carriage return and 
respond to the INPUT: prompt; then enter another carriage return and respond to the 
OUTPUT: prompt; and then enter another carriage return and respond to the OPTIONS: 
prompt. The user has an alternative and shortened procedure, using the asterisk (*) as 
described in the paragraph entitled ''Special Keyboard Control Keys". 



./-^i^ 
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NOTE 

1. If a syntax error was made, the prompt for the parameter Une 
in error will be displayed and the operator must reenter that 
parameter and all of the parameters for the prompt line follow- 
ing the one in error. 

2. If a utility program bid by the operator was illegal, the print- 
out or display readout presented in the paragraph entitled 
"TXDS Control Program Error Messages" will be displayed. 

8. After responding to the OPTIONS: prompt, the operator depresses the carriage return 
key and causes the program to be loaded into memory and then executed. When the 
program is loaded into memory, a title identifying the utility will be displayed. Observe 
the following printout /display from the system console if, for example, the TXLINK 
utility program was loaded: 



^ TXLINK 937537 ** 



^^^\ 



(where 937537 is the part number of the TXLINK utility program) 

After the loaded program has completed execution, observe the following printout or | 
display readout from the system console: 

TXDS 936215 ** 359/77 1:05 

PROGRAM: 

NOTE 

When the user desires to execute a task that already resides in 
memory without loading the task, a hexadecimal sign is entered, 
followed by the task ID (10). For example, after the TXEDIT utility 
program has been loaded into memory, it can be reexecuted as 
follows: 

TXDS 936215 ** 010/77 2:05 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



>10 

DSC:TASK2/SRC 
DSC: SCRATCH/SRC 
(carriage return) 



/^^'\ 



A description of the prompts and associated response-entries is provided in the following 
subparagraphs. 

2.3 RESPONDING TO TXDS CONTROL PROGRAM PROMPTS 

The operator's response to the PROGRAM:, INPUT:, or OUTPUT: prompt is used to specify 
(1) the device-name identifier of the input device on which the program to be loaded and executed 
is stored and/or (2) the file-name identifier of the program to be loaded and executed. When the file 
is on a diskette input device, the full response to any of the prompts requires inclusion of the 
diskette-name identifier (e.g. DSC, DSC2, DSC3, DSC4) and the file-name identifier (e.g. :TXLINK 
or :TXEDIT) and the extension. An example of a full response to a PROGRAM: prompt is: 

PROGRAM: DSC:TXLINK/SYS 
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When the file is on a non-diskette device such as a cassette unit, card reader, line printer or other 
I/O device, the full response to any of the prompts requires inclusion of solely the device-name 
identifier (e.g., CSl or CR). An example of a correct full response to a PROGRAM: prompt is: 

PROGRAM: CR 

Both device names and file names are called pathnames. 

2.3.1 PATHNAME SYNTAX. When a pathname is used to indicate a device, it consists of the 
one- to four-character device name assigned to that device during system generation (see the TX990 
Operating System Programmer's Guide). 

A pathname which designates a file has basically three fields: 

® A device or volume name to designate the diskette v^hich contains the file. A device name 
is the one- to four-character name assigned to the diskette drive during system generation. 
A volume name may only be used on customized TX990 operating systems which include 
volume name support (see the TX990 Operating System Programmer's Guide section on 
system generation). Volume names are also one to four characters. 

• A file name which is one to seven characters and separated from the device or volume 
name by a colon (:). The file name is specified when the file is created. The first character 
must be alphabetic (A-Z); the rest may be alphanumeric. 

® An extension to the file name which is one to three characters and separated from the file 
name by a slash (/). The extension may also be specified when the file is created. The first 
character must be alphabetic; the rest must be alphanumeric. Extensions are commonly ^m^ 

used to describe how a file is used, such as LST for listing files, SRC for source files, and 1 

OBJ for object files. 

No imbedded blanks are allowed in any of the three fields. 

When specifying pathnames in response to prompts made by any of the utihty programs, some of 
the fields may be omitted, and the utility uses a default value for that field. Table 2-1 shows the 
possible pathname variations. 



NOTE 

The default-substitutes mentioned in table 2-1 are determined by 
the utility program being executed. Consequently, in some utility 
programs, a default-substitute may not exist. Further, the utility 
program being executed also determines whether or not a default- 
substitute results in an error. 

The TXDS Control Program checks the syntax of all of the pathnames entered for utility programs 
before they are executed. If the pathname syntax is not legal, then the prompt associated with that 
entry is again printed out or displayed (to reprompt the operator). 



■^ 



,-^ 



^ 
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Table 2-1. Pathname Syntax Variations 

Explanation 

This is the full pathname response for a diskette file. An example is: DSC:TXLINK/SRC. 
No default-substitute is employed when a full response is made. 

The missing DEV causes the default diskette name, defined during system generation, 
to be used in the device field. 



Pathname 

DEV: FILE/EXT 
VOL: FILE/EXT 

:FILE/EXT 



DEV:FILE 
VOL: FILE 



This causes a blank to be provided for the extension. 



:FILE 



The default diskette name, defined during system generation, is used for the device field 
and a blank is used as the extension. 



:FILE/ 



DEV/EXT 
VOL/EXT 

/EXT 



DEV: 
VOL: 

DEV 



This causes the default diskette name, defined during system generation, to be used 
for the device field and the extension to be defaulted as specified in the utility program 
being executed. 

This causes a default-substitute to be provided for the file as specified in the utility 
program being executed. 

This causes the default diskette name, defined during system generation, to be used for 
the device field and the file default to be defaulted as specified in the utility program 
being executed. 

This causes the default diskette name, defined during system generation, to be used for 
the device field and the file and extension to default as specified in the utility program 
being executed. 

This causes a default-substitute to be provided for the file and extension as specified in 
the utility program being executed. 

This is a full device name. No default-substitutes apply. 



2.3.2 PROMPT-RESPONSES. The TXDS Control Program prompts the user to enter the program 
pathname, input pathname, output pathname, and option-selections. The TXDS Control Program 
then checks the pathnames for syntax. If the syntax is not correct, it will prompt the user again. 
After all of the responses to the prompts are entered, the TXDS Control Program loads and 
executes the specified program as task 1 Oi^ . 

2.3.2.1 PROGRAM: Prompt. The operator's response to the PROGRAM: prompt must specify 
either the pathname of the program to be loaded and executed, or the task ID of a program already 
in memory. 
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Only one pathname can be entered in response to the PROGRAM: prompt. When the program 
is to be loaded as a privileged task (enabhng the task to execute certain supervisor calls), the ^^^ 

user must enter the pathname followed by a ",P". A task, when not linked with the TX990 Opera- ' 

ting System, can only be made privileged when it is loaded. All tasks hnked with the TX990 Opera- 
ting System are privileged. 

When the user enters only a slash (/) for the extension field m the PROGRAM: prompt pathname, ^ 

the extension will default to SYS and SYS will be substituted into the pathname before any drives 
are searched. 

When a PROGRAM: pathname, for a diskette configuration, does not specify the diskette transport 

drive, the TXDS Control Program starts a device-file search beginning with the diskette transport 

drive that is the default-substitute defined during system generation. For a standard Tl-supplied 

TXDS system, the default-substitute is DSC. If the file is not on the diskette of the first default 

diskette transport drive, the TXDS Control Program will concatenate a 2 to DSC and the file search 

would then proceed to DSC2. In the same manner, the search continues to DSC3 and to DSC4. 

The search is only effective when the diskette default-substitute is the main diskette transport drive 

and when its device-name identifier is comprised of three characters, (i.e., DSC or any other three 

characters). It should also be noted that whenever the user specifies the device-name identifier in ^ 

response to the PROGRAM: prompt, only the specified device (e.g., the specified diskette transport 

drive) is searched. 

The file-name identifier for each utility program is listed in table 2-2. If a task ID is entered, it must 
be preceded by a "greater than" sign (>). 

2.3.2.2 INPUT: Prompt. The operator's response to the INPUT: prompt is used to specify the 
pathname of the input information needed by the program during its execution. For example: the 
TXMIRA utility program uses the response to the INPUT: prompt to specify the pathname of ^*^ 

the source file; the TXLINK utility program uses the response to the INPUT: prompt to specify the 
pathname of the individual object modules to be linked; and the TXCCAT utility program uses 
the response to the INPUT: prompt to specify the pathname of the individual files to be copied 
together. The other utility programs each use the response to the INPUT; prompt in the manner 
described under each of the utility program sections herein this manual. The operator can enter zero 
to three input pathnames separated by commas. The TXDS Control Program will check each para- 
meter for syntax. If the syntax is wrong, the TXDS Control Program will prompt the user again. 
The user must enter the entire line again. 



The INPUT: pathname default-substitutes for each utility program are listed and described in each 
utility program section of this TXDS Programmer's Guide and in each utility program section of 
the TX990 Operating System Programmer's Guide. 

2.3.2.3 OUTPUT: Prompt. The response to the OUTPUT: prompt is the pathname for storage of 
the output information. For example: the TXMIRA utility program uses the response to the 
OUTPUT: prompt to specify the pathname where object is stored and assembly source tile listings 
are to be presented; the TXLINK utility program uses the response to the OUTPUT: prompt to 
specify the pathname where the linked object is to be stored and where load map listings are to be 
presented; and the TXCCAT utihty program uses the response to the OUTPUT: prompt to specify 
the pathname where the copied files are to be stored. The other utility programs each use the 
response to the OUTPUT: prompt in the manner described under each of the utiHty program 
sections herein this manual. Up to three pathnames (separated by commas) can be entered in 
response to the OUTPUT: prompt. 

The OUTPUT: pathname default-substitutes for each utility program are listed and described in 
each utility program section of this TXDS Programmer's Guide and in each utility program section 
of the TX990 Operating System Programmer's Guide. 
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2.3.2.4 OPTIONS: Prompt. The operator's response to the OPTIONS: prompt is used to specify 
jP^ • the option(s) selected from the total alternative options available for the program which is to be 

' loaded and executed. These options are described in the apphcable utihty program section in this 

TXDS Programmer's Guide or in the TX990 Operating System Programmer's Guide. 



Table 2-2. UtUity Program File-Name Identifiers 



/flw!»\ 
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File Name Identifier 

GENTX/SYS 

OBJMGR/SYS 

BACKUP/SYS 

SYSUTL/SYS 

LIST80/SYS 

DSKDMP/SYS 

TXMIRA/SYS 

TXXREF/SYS 

TXLINK/SYS 

TXCCAT/SYS 

TXEDIT/SYS 

IBMUTL/SYS 

TXDBUG/SYS 
TXLUNO/SYS 



Utility Program 



1 3 



System Generation 
Object Manager ^ » ^ 

Diskette Backup ^ » ^ 

-System Utility ^ ' ^ 

list 80-80 ^ ' ^ 

Diskette Dump * » ^ 

Assembler ^ 

Cross Reference ^ 

Linker ^ 

Copy Concatenate ^ 

Text Editor ^ 

IBM Diskette Conversion 

Standalone Debug^ 
LUNG Assignment^ ^ 



J^m^^\ 



Notes: 

* " TX990 Operating System utility program. 

^ " TXDS Terminal Executive Development System utility program. 

^ " Capable of being loaded and executed using OCP commands or 
the TXDS Control Program. 

This utility can only be excuted using OCP. 

2.3.3 SPECIAL KEYBOARD CONTROL KEYS. The special keyboard control keys are described 
as follows: 



j^^^\ 



1 . RUB OUT/DELETE LINE 



2. CONTROL H/Back Arrow 



3. Carriage Return /NEW LINE 



Allows the operator to reenter a parameter. 
Pressing the RUB OUT key causes a line feed 
followed by a carriage return. The operator may 
then enter the Une again. 

Allows the operator to backspace by character 
and correct a typing error. 

Causes TXDS Control Program to terminate if 
the carriage return or NEW LINE was the only 
entry in response to the PROGRAM: prompt, 
otherwise terminates a prompt line entry. 
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4. ESCAPE/RESET 



6. & 



7. 



If an ESCAPE or RESET is entered during a 
print out, the TXDS Control Program terminates. 

Causes a default to be activated when entered 
as the response to the INPUT: or OUTPUT: 
prompts. 

In any prompt line, pressing the & key as the 
first character in the response causes the TXDS 
Control Program to restart with the PROGRAM: 
prompt. 

When entered after a prompt line entry, in place 
of a carriage return, permits the next prompt 
line to be entered without being prompted by 
the TXDS Control Program. When a prompt line 
is terminated with an asterisk (*) followed by a 
carriage return, no more prompts are given and 
default-substitutes are made by the utiHty pro- 
gram for those pathnames not entered. The ex- 
perienced user can enter all or several of the 
parameters on one prompt line. 



^ 



^ 



The following examples utilize the asterisk (*) feature in lieu of the INPUT:, OUTPUT:, and 
OPTIONS: prompts: 

Example 1 : 

To load the TXEDIT utility program after the TXDS Control Program has been loaded, the 
asterisk (*) is used as presented in the following example: 

TXDS 936215 ** 010/77 2:05 

PROGRAM: DSC:TXEDIT/SYS*DSC:TASK2/SRC*DSC:SCRATCH/SRC* 

(where DSC:TASK2/SRC is the INPUT: pathname; DSC: SCRATCH/SRC is the OUTPUT: 
pathname; and the OPTIONS: entry is provided by the default-substitution specified in the 
TXEDIT utility program.) 

The above can also be entered as follows: 

TXDS 936215 ** 010/7/ 2:05 

PROGRAM: DSC:TXEDIT/SYS 

INPUT: DSC:TASK2/SRC*DSC:SCRATCH/SRC* 

Example 2: 

To load the SYSUTL utility program after the TXDS Control Program has been loaded, the 
asterisk (*) is used as follows: 

TXDS 936215 ** 101/77 2:05 

PROGRAM: :SYSUTL/SYS***CF,:TEMP/OBJ 



/■<?»% 
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(where the INPUT: and OUTPUT: parameters are null and the OPTIONS: parameter is 
CF,:TEMP/OBJ. 

NOTE 

1. In the above examples, it is necessary to press the carriage 
return key at the end of the parameter line to cause the pro- 
gram to be loaded and executed. 

2, If a parameter line ends with an asterisk (*) and a pathname is 
not entered for each prompt, then default substitutes are made 
by the utility program for those pathnames not entered. 



Example 3: 



The following example utiUzes the comma (,) to cause a default-substitution to be made in the 
OUTPUT: pathname below. 

TXDS 9326215 ** 010/77 2:05 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXMIRA/SYS 

:TASK1 

,CRT 

M800,X,L 



(where the OUTPUT: pathname defaults to a substitute specified in the TXMIRA Assembler 
utility program.) 

The following example utilizes both the asterisk (*) and the comma (,) special keyboard controls: 

To load the TXMIRA Assembler utility program after the TXDS Control Program has been 
loaded, the asterisk (*) is used as follows: 

TXDS: 936215 ** 010/77 2:05 

PROGRAM: :TXMIRA/SYS*:TASK1*,CRT*M800,X,L 

(where TASKl is the INPUT: pathname and where the OUTPUT: pathname is the default- 
substitute provided in the TXMIRA Assembler utihty program.) 

2.4 BACKING UP TI-SUPPLIED DISKETTES 

Before the Tl-supplied TXDS diskettes are used, they should be backed up onto scratch diskette(s): 
(1) to ensure that a backup diskette is available if the diskette(s) is destroyed; and (2) to ensure 
that either of the two diskettes (i.e., the original diskette and the backup diskette) will always be 
available to do future system generations with the use of a minimum 16K-memory configuration. 

Backup the system diskette by performing the following step-by-step procedure: 

1. Remove the system diskette from diskette transport drive 1 and insert in its place the 
TX990 parts diskette. 

[^' 2. Take a scratch diskette and place it into diskette transport drive 2. 
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3. Start the backup procedure by bidding the BACKUP utility as follows: 

PROGRAM: :BACKUP/SYS*(C/R) 

NOTE 

(C/R) signifies a NEW LINE entry on a 913 VDT, a RETURN on a 
91 1 VDT, and a cairiage return on an ASR. 

The items underlined below are the user's responses to the prompts. 

The Diskette Backup and Initialize Utility is loaded: 

BACKUP & INITIALIZE UTILITY 9362 12* A 
OUTPUT DISC OR VOLUME NAME? DSC2 (C/R) 

4. If the diskette is not initialized the following message is displayed: ,,«. 

THE OUTPUT DISC MUST BE INITIALIZED 

5. If the diskette is initialized, the following message is displayed: 

DELETE ALL FILES ON DSC2? (Y/N) N(C/R) 

6. The rest of the procedure is: 

INITIALIZE DSC2? (Y/N) Y(C/R) ^ 

OUTPUT DISC ID SCRATCH DISR (C/R) 
OUTPUT VOLUME NAME BKUP (C/R) 

After the diskette is initialized, the following will be printed: 

COPY FILES? (Y/N) 

At this point remove the diskettes from drive 1 and load the system diskette to be backed up. Then ^ 

respond to the prompt as follows: 

COPY FILES? (Y/N) Y(C/R) 

VERIFY FILES? (Y/N) Y(C/R) 
INPUT PATHNAME? DSC (C/R) 

ERROR LOG: 



^ 
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For a discussion of any error messages which are output at this point, see the Diskette Backup 
UtiUty section of the TX990 Operating System Programmer's Guide. 

THE DISC IS NOW BEING VERIFIED 
ERROR LOG: 

For a discussion of any error messages which are output at this point, see the Diskette Backup 
UtiUty section of the TX990 Operating System Programmer's Guide. 



FINISHED! 

COPY FILES? (Y/N) 



N(C/R) 



VERIFY FILES? (Y/N) N(C/R) 
SYSTEM FILE PATHNAME: DSC2 

If the backed up diskette has a system file on it, respond to the prompt with the name of that file. 
For example, if the system file was :SYSASR/CMP, the response should be: 



SYSTEM FILE PATHNAME? 



DSC2 : S YS ASR/CMP(C/R) 



Termination of BACKUP is accomplished by entering an asterisk to the next prompt: 

OUTPUT DISC OR VOLUME NAME: *(C/R) 
BACKUP Sl INITIALIZE UTILITY ENDED 
TXDS 936215 ** 

2.5 TXDS CONTROL PROGRAM ERROR MESSAGES 

Refer to table 2-3 for a list of error messages, the reason for each error, and the recovery method. 



Error 
nn - BAD PGM LOAD 

-BAD PGM LOAD 
nn - CANT BID TASK 



CANT GET COMMON- 
ABORTED 



Table 2-3. TXDS Control Program Error Messages 
Reason 



nn represents error code listed 
in Error Appendix D. 

Cannot find object file. 

nn represents the task state code 
of task 10 16 listed in State Code 
Appendix C. 

System was configured without 
COMMON. 



Recovery 

Reenter parameter 

Reenter parameter 
Reenter parameter. 



Configure a system with 168 
bytes of common. 
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SECTION III 
VERIFICATION OF OPERATION 

3.1 INTRODUCTION 

This section provides several short procedures to verify that the software is operating properly. 
These procedures are listed below and described in the following procedural steps: 

• Load and Initiahze TX990 Operating System 

• Load and Initialize TXDS Control Program 

• TXCCAT Verification Procedure 

• TXEDIT Verification Procedure 

• TXMIRA Verification Procedure 

® OBJMGR Verification Procedure 

I 

• TXLINK Verification Procedure 

The Operating System Diskette mentioned in the procedure refers to either TXDS System 
Diskette 2 (for VDT systems) or TXDS System Diskette 3 (for ASR systems). 

3.2 REQUIREMENTS 

This procedure requires the following items in addition to the required hardware for a TXDS 
system: 

• TX990 Operating System Programmer's Guide 
® TXDS System Diskette 

^ • TX990 Parts Diskette 

3.3 OPERATION 

The following steps of the verification procedure demonstrate that the system is operational. 

1 . Initialize TX990 by loading TXBOOT from TXDS system diskette. 

•a 

a. Insert TXDS System Diskette in diskette drive #1 . | 

b. On the front panel, press the following pushbutton switches to load the system. 

HALT 

RESET 

LOAD 

^^' c. Bid the TXDS control program by entering ! at the system console. | 



/^^\ 
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2. Place scratch diskette in drive #2. If diskette is not initialized; place TX990 Parts 

Diskette in diskette transport drive #1 and execute the Disc Backup and Initialize ^^ 

(BACKUP) utility program as described in Section X of Model 990 Computer TX990 
Operating System Programmer's Guide. Replace the System Diskette in transport drive 1. 

3. Copy :TXTST1/SRC from System Diskette to scratch diskette using TXCCAT. With 
System Diskette in transport drive 1 and the scratch diskette in transport drive 2, enter 
the following commands to copy :TXTST1/SRC to the scratch diskette: 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



DSC:TXCCAT/SYS 
DSC:TXTST1/SRC 
DSC2:TXTST1/SRC 
(carriage return) 



After completion of the copy, TXDS will come up and should be given the following 
parameters in order to execute TXEDIT: 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



DSC:TXEDIT/SYS ^ 

DSC2:TXTST1/SRC 

(carriage return) 
(carriage return) 



5. Position TXEDIT to line 19 of TXTSTl/SRC using the DOWN (D) command and print 
the line to assure that the pointer is positioned correctly. 

?D19 

The following line should be printed 
19 DATAOLD.CNTl 

6. Edit hne 19 to enable printing the new message by using the Change (C) command. 
Replace Une 19 with the following hne, spacing the DATA over seven spaces and the 
NEW,CNT one more space. 

7C19-19 '-^ 

DATA NEW,CNT 

Enter an extra carriage return to terminate the Change command. 

7. Print line 18 and the modified line to ensure the change has been made correctly. 

?T 

?D17 

?P2 

18 BLWPr«)WRITE PRINT MESSAGE 

DATA NEW,CNT 



^ 
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8. Terminate the editing session by executing the Quit (Q) command. 

?Q 

Upon executing the Quit command, TXEDIT issues a prompt to ensure that it is time 
to terminate. After responding with a 'T', the current input file and buffer are copied 
to the output scratch file. Respond with a 'Y' when asked if the scratch file is to be 
copied to the input file. 

TERMINATE/CONTINUE?! 

TEXT IN SCRATCH FILE 
TRANSFER TO INPUT? Y 
END EDIT 

TXEDIT is then terminated and the TXDS control program is rebid. 

9. Now assemble TXTSTl/SRC using TXMIRA. The assembled object is directed to the file 
TXTSTl/OBJ on the scratch diskette. The object is designated as compressed object on 
the options line. The assembly output listing is listed to the default system printer as 
specified in the OPTIONS: parameter. Also, the cross reference listing output from 
TXXREF is listed to the default system printer. The sample output listings are illustrated 
in figure 3-1. 

Enter the following parameters. 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



DSC:TXMIRA/SYS 
DSC2:TXTST1/SRC 
DSC2:TXTST1/0BJ 
C,L,X 



The output listing should reflect the changes made in step 6. Verify that no errors are 
detected by TXMIRA. 

10. Place TX990 Parts Diskette in drive #1 . 

11. Object Manager is then loaded and executed to combine the three required object 

l#K modules into one module for linking into the TX990 System. Execute the object manager | 

as follows: 

PROGRAM: DSC:OBJMGR/SYS* 

990 OBJECT MANAGER 939870** I 

After printing the above message, object manager requests specification of a file in which 
the combined object is to be placed. At this point the TX990 Parts Diskette should be 
removed and the System Diskette installed in drive #1, After specifying the output file, 
enter the pathname of the three required object files and designate that each input file 
is to be copied and rewound. 



/^^N 



^'^^"8^ 3 3-3 Digital Systems Division 




946258-9701 



TXTSTl TXMIRR 93622? >^* 
TXDS TEST PROGRRM 9378ei8-9901*'*c 



17 : 12 : 92 



0002 

0003 * 

0004 

0005 ♦ 

0006 0000 0006' 
0002 0045^ 
0004 0000 

0007 0006 TSTWSP BSS 32 

0008 0026 1600 ENDPRG DRTfi :>1600 



IDT -TXTSTl- 

REF CNT.. NEW. WRITE 

DRTR TSTWSP.. STRRT. 



0009 




* 






0010 






DXOP 


SVC. 15 


0011 




* 






0012 0028 


0D 


OLD 


BVTE 


>0D. >0ft, >0ft 


0029 


0ft 








002fl 


0fl 








0012 002B 


20 




TEXT 


' OLD MESSftGE - 


0014 0043 


0D 




BVTE 


>0D. >0ft 


0044 


0fi 








0015 


001D 


CNTl 


EQU 


*-OLD 



088/77 PftQE 0001 



Eh4D OF PROGRfiM OP CODE 
*** DEFINE XOP 

- WRONG ! ! ' 



^ 



TXTSTl TXMIRfl 936227 ** 
TXDS TEST PROGRAM 937808-9901** 



17 : 12 : 82 



0017 STftRT 

0018 0046 0420 

0048 0000 

0019 004fl 0028' 
004C 001D 

0020 004E 2FE0 
0050 0026 

0021 

0000 ERRORS 



TXXREF 927542 ** 



CNTl 


0015 


ENDPRG 


0008 


NEM 




OLD 


0012 


STftRT 


0017 


SVC 




TSTWSP 


0007 


WRITE 





BLWP ©WRITE 
DflTfl OLD, CNTl 
SVC ©ENDPRG 
END 



17 : 12 : 23 



0004 

0019 

0020 

0004 
0015 

0006 
0010 
0006 

0004 



THERE ftRE 0009 SVMBOLS 



0019 



0018 



088/77 



088/77 PAGE 8002 



PRINT MESSAGE 



END OF PROGRftM 



^**^ 



'"^N 



PAGE 0001 
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Figure 3-1 . TXMIRA Sample Output Listing 
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OUTPUT FILE: DSC2:TXTST/OBJ 

INPUT FILE: DSC2:TXTST1/0BJ 

REWIND INPUT FILE? Y 
TXTSTl ? C 

END-OF-FILE 
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INPUT FILE: DSC:TXTST2/0BJ 

REWIND INPUT FILE? Y 

TXTST2 ? C 

END-OF-FILE 

INPUT FILE: DSC:TXTST3/OBJ 

REWIND INPUT FILE? Y 
TXTST3 ? C 

END-OF-FILE 

INPUT FILE: * 
END OBJECT MANAGER 

Object manager terminates upon entering an asterisk on the input line. 



12. Place the System Diskette in diskette drive 1. Execute TXLINK to link the object 
manager output as follows: 



/^^N, 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



DSC:TXLINK/SYS 
DSC2:TXTST/0BJ 
DSC2 :TXTEST/OBJ,LOG 
CITXTEST.L 



TXLINK 937537 ** 



The output line contains the name of the file TXTEST/OBJ in which the linked object 
is to be placed, as well as the device to which the load map is directed. 'C specifies that 
the object is to be compressed, 'ITXTEST' designates that the IDT for the linked object 
is to be TXTEST, and 'L' specifies that the output of TXLINK is to be listed. The default 
memory size of 12K is available for the link. 



/^^^ 



Following is the link output. 

TXLINK 937537 *A 10:51:01 

TXTEST LENGTH OOAO 



032/77 



PAGE 0001 



MODULE 



LENGTH 



ORIGIN 



DATE 



TIME 



TXTSTl 
TXTST2 
TXTST3 



0052 
001 E 
0030 



0000 
0052 
0070 



01/25/77 
01/25/77 



15 
15 



11 
14 



ACNT 



00 ID NEW 



DEFINITIONS 
0052 WRITE 0070 



j^^\ 
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13. The TXDS Test Program is now ready for execution. Execute by entering the compressed 

object module name on the program line followed by *. Upon executing, the following "^ 

message is issued prior to termination and TXDS is rebid. 



PROGRAM : DSC2 : TXTEST/OB J * 
HAVE A GOOD DAY !! 






^""^^ 



.xsasv 



/"^^^Jv 
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V SECTION IV 

CREATING AND EDITING PROGRAM SOURCE CODE I 

4.1 INTRODUCTION 

The TXDS Text Editor (TXEDIT) Utility Program provides the user/programmer with the capability ■ 
of editing the text of source programs and object programs and, in addition, the capability of 
creating source programs. Basically, 21 TXEDIT commands are available to fulfill the programmer's 
needs. The commands are grouped as follows: 

• Setup commands: 

Start Line Numbers (SL) command 
JPK^ Stop Line Numbers (SN) command 

Set Print (SP) column margin number command 
Set Margin (SM) for Find command 
Set Tabs (ST) command 

• Pointer-Movement commands 
\ Down (D) command 

Up (U) command 
Top (T) command 
Bottom (B) command 

• Edit commands 

Change (C) command 
Insert (I) command 
Move (M) command 
Remove (R) command 
Find (F) string command 

• Print commands 

Limits (L) command 
f^' Print (P) command 
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• Output commands 

Keep (K) command 
Quit (Q) command 
End (E) command 

• Terminate-Sequence commands 

Terminate (T) command 
Continue (C) command 

All of the TXEDIT commands are capable of being entered via the keyboard of the system console 
To edit a program or record, the user must first have the program or record recorded on a TI disk- 
ette or cassette. The text is then edited by feeding it from the TI diskette or cassette (hereinafter 
referred to as the mput file) into a memory buffer where the editing is performed and then out to 
the scratch file (until an EOF character is read or a Quit command is entered). If further editing is ^ 

required, the text data is reversed to flow back from the scratch file into the memory buffer and 
back to the input file (until the EOF is read again or a Quit command is entered again). This trans- 
fer between the two files (with multiple editing activities being automatically performed during 
each pass) continues until the user is finished. At that time, the TXEDIT program provides a print- 
out or display on the system console which states whether the input file or the scratch file contains 
the final edited text. The user then has the option of using a command to transfer the resultant final 
edited text back to the input file in substitution of the preedited source program or the preedited 
object program or record. 

CAUTION ■ 

The user should ensure that the input file is not destroyed by 
copying it onto a temporary file diskette or cassette. 

The TXEDIT program may be executed in a Model 990/4 microcomputer or a 990/10 minicom- 
puter configured to support a TX990 Operating System. The minimum configuration includes a 
computer with 16K of memory and an interactive operator system console, the LOG. 

The following paragraphs describe various TXEDIT program functions and procedures. A TXEDIT ^ 

loading procedure is presented. Specific editing procedures using the TXEDIT commands are 

presented for: changing, adding, moving, or removing source or object records in the buffer and to 

locate and modify a character string in a group of records; using editor commands to move the text 

editor's buffer line pointer; moving lines/text into and out of the buffer; and using special terminal 

keyboard characters. Procedures for coding source or object files and writing a new source program 

are also explained. A description of possible error and warning messages is provided. Concluding 

this section is an example of how to enter and edit a source program and a discussion of how to 

edit an object program. 

4.2 LUNOs 

LUNOs 7 and 8 are assigned by the text editor. LUNO 7 is assigned to the input file, and LUNO 8 
is assigned to the output file. The text editor uses the system console as the interactive device. 
When the text editor terminates, all files are closed and all LUNOs are released. 
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4.3 LOADING TXEDIT 

The user can load the TXEDIT utility program only by use of the TXDS Control Program. (The 
TXEDIT utility program cannot be loaded via OCP.) After the TXDS Control Program is executed | 
using the procedure in Section II, responses to the TXDS Control Program's PROGRAM:, INPUT:, 
OUTPUT: and OPTIONS: prompts are then entered by the user via the keyboard of the system 
console. The user responds to the PROGRAM: prompt as follows: 

PROGRAM: :TXEDIT/SYS | 

The response to the INPUT: prompt requires the pathname of the source program file location on 
diskette or cassette. If the diskette file is specified by the pathname and none exists, it will be 
created. This is the correct procedure for generating a new source file. An insert (I) command may | 
then be used to generate lines of source code. The response to the OUTPUT: prompt requires the | 
pathname of the scratch file location on diskette or cassette. If the diskette file is specified by the 
pathname and none exists, it will be created. The OUTPUT: file pathname must not be the same as 
the INPUT: file pathname. In response to the OPTIONS: prompt, the user may specify the size of 
the memory buffer. Under the TXEDIT utility program, this is the only option available to be 
specified. The size of the memory buffer is specified by the user entering an M followed by a deci- 
mal number (which may vary from one to five characters in length). The decimal number specifies 
the number of bytes to be used for the memory buffer. The memory size is determined using the 
following procedural example: if the user wishes to edit 75 lines of text, each character on each 
line is used to specify one byte; further, each line is preceded by a six-byte header and followed 
by a one-byte carriage return. Consequently, if each line of text has an average length of 40 bytes 
plus 6 bytes for the header and 1 byte for the carriage return, then 75 lines of text would require 
3525 bytes. 

An example of loading TXEDIT from diskette follows: 

TXDS 936215**0017 2:10 | 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXEDIT/SYS I 

DSC2: UPDATE/SRC 

M4000 I 



The above response-entries to the prompts cause the TXEDIT utility program to be loaded from 
diskette into memory and then to be executed. The OUTPUT: pathname is provided by the 
r" TXEDIT utility program with : SCRATCH/SRC as the default-substitute. 

An example of loading a file from cassette follows: 

TXDS 936215**0017 2:10 | 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXEDIT/SYS | 

CSl 

M4000 



The above response-entries to the prompts cause the TXEDIT utility program to be loaded from 
diskette into memory and then to be executed. 
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Table 4-1. TXEDIT Default-Substitutes 



Entry 


Pathname 


Default-Substitute 


INPUT: 


DEVICE 


Default disc drive 




FILE 


No default-substitute 




EXTENSION 


SRC 


OUTPUT: 


DEVICE 


Default disc drive 




FILE 


SCRATCH 




EXTENSION 


SRC 


OPTIONS: 


M (memory) 


3000 bytes 


4.4 COMMANDS 







.-^ 



4.4.1 GENERAL. The TXEDIT utility program supplies 21 edit commands to fulfill the user's 
needs. Further, eight special keys/characters are also provided to meet general utiHty needs (e.g., 
RUB OUT, ESC, et. al.). The commands are entered at the keyboard of the system console in 
response to the printing of a question mark (?); and after the command is entered, it is executed by 
entering a carriage return. The syntax of the command is free form in that one or more spaces may 
be inserted between characters and operands of the commands. A list of the commands and a brief 
description of each command is provided in table 4-2. The detailed descriptive information pertain- 
ing to each command is provided in the following paragraphs. 

4.4.2 COMMAND OPERANDS. Command operands are used to specify a number of lines, Une 
numbers, or displacements from the pointer. The edit commands and one of the print commands 
may specify a group of lines by first and last line number of by a number of lines relative to the 
pointer. 

4.4.3 SYMBOL DEFINITION. The symbols used in conjunction with TXEDIT commands are 
defined as follows: 



^ 



/^!«5¥V 



Angle brackets < > enclose items required to be supplied by the user. 

Brackets [ ] enclose optional items. 

Braces | [ enclose items between which a choice must be made; one, and only one, of 
the items must be included. 



^^ 



Items in capital letters must be entered as shown. 

NOTE 

The syntax definitions and examples presented in this section do not 
have spaces between the characters of the two-character commands, 
between the command and operands, or between operands. Spaces 
may be entered at these points if desired, and all operands are 
decimal numbers. 



y^«fK 
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Table 4-2. List of Commands and Special Keys/Characters 

Command Syntax Description 

SETUP COMMANDS 

SL Start Line numbers (SL) command causes line numbers to be printed with 

each line of text. 

SN Stop line Numbers (SN) command causes line numbers not to be printed. 

SP Set Print margin (SP) command sets the right boundary for print display. 

SM Set Margin (SM) for Find command sets the left and right boundaries for 

the Find command. 

ST Set Tabs (ST) command sets up to five tab stops. 

POINTER-MOVEMENT COMMANDS 

D Down (D) command moves the pointer down toward the bottom of the 

buffer. 

U Up (U) command moves the pointer up towards the first line in the buffer. 

T Top (T) conmiand moves the pointer to the first line in the buffer. 

B Bottom (B) command moves the pointer to the last line in the buffer. 

EDIT COMMANDS 

C Change (C) command removes lines from the buffer and inserts new ones in 

their place. The new lines are input from the terminal. 

I Insert (I) command takes input from the terminal and places the new lines 

into the buffer. 

M Move (M) command moves lines from one place in the buffer to another. 

R Remove (R) command deletes lines from the buffer. 

F Find string (F) command searches for the first occurrence of a character 

string in a line and replaces it with another string of characters. 

PRINT COMMANDS 

L Limits (L) command causes the first Une and the last line to be displayed. 

P Print (P) command displays Hnes of text. 
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Table 4-2. List of Commands and Special Keys/Characters (Continued) 
Command Syntax Description 

OUTPUT COMMANDS 
K 



Keep (K) command takes lines of text out of the buffer and puts them in 
the output file. 



/<^ 



TorC 



CTRL-H 

RUB OUT 
CTRL-I 

ESC/RESET 

position keys 



DELETE LINE 



TAB 



Quit (Q) command takes lines of text out of the buffer or the input files 
and puts them in the output file. 

An (E) command terminates without writing an EOF to the output file. 

TERMINATE'SEQUENCE COMMANDS 

Allows the user to make multiple single directional editmg passes on a 
source or object program. 

SPECIAL KEYS/CHARACTERS 

Pressing the control key and the H key simultaneously on the hard copy 
terminal causes the terminal to backspace a character to enable rewriting 
over an entered character-error. 

The RUB OUT key causes the line just entered to be deleted so that a new 
line can replace it. 

Pressing the control (CTRL) key and the I key simultaneously on a hard- 
copy terminal causes a tab stop to be entered in the input string, although 
only one space will be echoed on the terminal. 

Pressing the ESCape or RESET key on the system console causes a display 
to be aborted. 

When using a VDT, only the left position key (^) and the right (-^) position 
key are recognized. The up and down position keys cause garbage to be 
entered into the input string. The left position key causes characters to be 
deleted from the character string; a right position key causes whatever was 
under the cursor to be entered. 

DELETE LINE on a VDT acts the same as a RUB OUT on a hardcopy 
terminal. 

A SPACE character is echoed. The TAB is interpreted by the text editor and 
spaces are inserted to fill the text line to the next TAB setting. Refer to 
paragraph 4.4.5.5 which follows. 



^ 



^'*%y 



.^'^m^ 



4^ 



Digital Systems Division 




946258-9701 



4.4.4 SPECIAL KEYS/CHARACTERS. The following special characters are recognized by the text 
^'^^ editor when the terminal is an ASR or KSR. A backspace character (CTRL H) backspaces one 

character position. A RUB OUT character deletes the Une that has just been entered from the key- 
board. On an ASR or KSR, a tab (CTRL I) echoes as one space upon character input, but moves to 
the nearest tab stop when the line is printed. (Tab stops are initially defined at character positions 
8, 13, 31, and 33.) An escape (ESC) entered from the keyboard during print output causes the cur- 
^ rent I/O operation and the command to be aborted; a question mark (?) prompt is then printed out 

or displayed, to which another TXEDIT command-response-entry can be made. 

The following special characters are recognized by the text editor when the terminal is a VDT. The 
position keys will move the pointer for backspace, or forward space. The DELETE LINE key will 
delete the line that has just been entered from the keyboard. The RESET key, when entered during 
a printout, causes the current I/O operation and the command to be aborted. If the space bar is 
entered during a printout, the printout will halt until the space bar is entered again. This allows the 
user to scan the printout before it rolls off the top of the screen without aborting the I/O operation. 

4.4.5 * SETUP COMMANDS. Setup commands may be entered immediately following loading of 
^ TXEDIT to: set limits for the Find command; set the right margin for printing; enable or inhibit 

printing of line numbers; set tabs. If no Setup command is entered, line numbers are printed. The 
right margin for lines or print corresponds to column 72. Columns 1 through 72 are scanned by the 
Find command, and tabs are preset at 8, 13, 31 , and 33, which are the standard columns for source 
code instructions, operands, and comments. 

Setup commands may be entered anytime during an editing session. It is often desirable to change 
the Find command limits before entering a Find command, so that only certain columns are 
searched. The user may want to inhibit the printing of line numbers to enable more source codes to 

rbe printed on a line. If the user is generating code to be assembled by TXMIRA, he may want to 
set the right margin to column 60, since TXMIRA does not scan characters past column 60. 

4.4.5.1 Start Line Numbers (SL). The Start Line Numbers (SL) command causes TXEDIT to 
print line numbers to the left of each statement or record. Syntax for the SL command is as 
follows: 

SL 

The SL command is used to restore printing of line numbers after line number printing has been 
^ inhibited by execution of an SN command. 

4.4.5.2 Stop Line Numbers (SN). The Stop Line Numbers (SN) command causes TXEDIT to omit 
printing of line numbers except in the message resulting from the Limits (L) command. The syntax 
for the SN command is as follows: 

SN 

The SN command may be entered initially or at any time during the edit operation. Omitting the 
line numbers when editing object code may be desirable to permit printing the entire record. 

4.4.5.3 Print Margin (SP). The Print Margin command specifies the column number of the right 
margin where printing is to end, except for the message resulting from the Limits (L) print com- 
mand, described in this section. The syntax for the SP command is as follows: 
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The s represents the column number of the right margin where printing is to end (i.e., one of the 

columns between 10 and 80, inclusive). If line numbers are being printed, the line numbers are ^...^ 

included in the margin column. Line numbers use six columns, so that if the right margin is ^ 

column 60, only 54 characters plus 6 line number character digits and blanks for spacing are 

printed. The following example shows an SP command that specifies column 60 as the right margin 

for printing: 

?SP60 

4.4.5.4 Set Margin (SM). The Set Margin (SM) command specifies left and right limits for the Find 
command. Syntax for the SM command is as follows:: 

SMs,t 

There must be a comma between s and t. The Find command scans from column s through column 
t and may be limited to the desired field by the SM command. The default value for the scan limits 
is from column 1 to column 72 (or the end of the line if less than 72). The following example shows 
an SM command that limits the scan of subsequent Find commands to columns 8 through 25: 

?SM8,25 

4.4.5.5 Set Tabs (ST). The Set Tabs (ST) command allows up to five tabs to be set between 
column 1 and 72. Syntax for the ST command is as follows: 

STn,n,n,n,n 

NOTE 

There must be a comma between every column number. The column 
number is indicated by n. Tabs must be set in ascending order, and 
if they are not, a blank will be inserted for the descending tab. If 
more than five tabs are entered, an INVALID OPERAND error 
message is issued; however, the first five tabs are set and ready for 
use. If no column numbers are entered, all tabs are cleared. 

4.4.6 POINTER-MOVEMENT COMMANDS. Pointer-movement commands may be used to move 
the pointer to any Une in the buffer of TXEDIT. Initially, the pointer is at line 1. Moving the 
pointer with the Down (D) command past the last linQ in the buffer causes TXEDIT to read source 
lines or object records from the input file to fill the empty lines. Other commands move the pointer 
upward a specified number of lines, or to the top of the buffer, or downward to the bottom of the 
buffer. The pointer-movement commands permit the user to move the pointer as desired for effec- 
tive use of commands that identify lines by specifying a displacement from the pointer. The pointer 
commands are described in the following subparagraphs. 

4.4.6.1 Down (D). The Down (D) command causes TXEDIT to move the pointer down a specified 
number of lines. When the specified move is to a Une number greater than the contents of the 
buffer, TXEDIT adds lines to the buffer and reads records from the input file to fill these lines. The 
syntax for the D command is as follows: 

Dn 



..^ 



^ 



^"^^ 
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The pointer is moved down n lines. Tlie range of n is 1 to 9999, and the default value when n is 
omitted is 1 . The D command may be entered to read in lines from the input file or to move the 
pointer to a line farther down in the buffer. Initially, or when the pointer is at the bottom of the 
buffer, TXEDIT reads n lines from the input file. When the pointer is m lines above the bottom of 
the buffer and n is greater than m, TXEDIT reads n - m lines from the input file. In each of these 
cases, the pointer is at the bottom of the buffer after execution of the D command. However, when 
the pointer is m lines above the bottom of the buffer and m is greater than or equal to n, no lines 
from the input file are read. The pointer is m - n lines above the bottom of the buffer after execu- 
tion of the command. The following example shows a D command to move the pointer down 
30 lines. 

?D30 

4.4.6.2 Up (U). The Up (U) command moves the pointer up a specified number of lines. Syntax 
for the U command is as follows: 

Un 

The pointer is moved up n lines. The range of n is 1 to 9999, and the default value when n is B 
omitted is 1 . The U command may be entered to move the pointer up to a specific line in the buf- 
fer. The following example shows a U command to move the pointer up 6 lines: 

?U6 

4.4.6.3 Top (T). The Top (T) command moves the pointer to the first line in the buffer. The 
syntax for the T command is as follows: 



4.4.6.4 Bottom (B). The Bottom (B) command moves the pointer to the bottom (i.e., last) line in 
the buffer. The syntax for the B command is as follows: 

B 

4.4.7 EDIT COMMANDS. The edit commands add, change, remove, rearrange, or scan lines of 
source or object code, and act upon a set of lines in the buffer specified by line number or by a dis- 
placement from the pointer. The edit commands are described in the following paragraphs. 

4.4.7.1 Change (C). The Change command deletes a specified set of Hues and permits input of one 
or more lines to replace the deleted lines. The syntax for the command is as follows: 

<s> - <t> 

H [<n>]; 

-<n> 

Line s through line t are deleted, or n lines with respect to the pointer are deleted. The values of s 
and t can be equal. As many replacement lines as required are entered. Each line is followed with a 
carriage return; the last line is followed with two carriage returns. When n is preceded by a minus 
sign, n lines preceding the pointer line are deleted, but the pointer Hne is not deleted. The new lines 
are inserted in their place. When n is unsigned or is preceded by a plus sign, n lines beginning with 
the pointer line are deleted, and the new lines are inserted. When no operand is entered, the pointer 
line is deleted, and replaced by the new Unes. When the pointer line is deleted, the pointer is moved 
to the next line of the buffer following the newly inserted lines. If the line that was changed was the 
last line in the buffer, the pointer will be at the first line in the buffer. The following example 
shows a C command to change lines 5 through 7, replacing them with four lines. 
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?C5-7 




LOD MOV 


1,4 


AI 


4,1 


CI 


4,WA+60 


JLT 


SUM 



The following example shows a C command to change the pointer line and the two lines that follow 
the pointer, replacing them with two lines: 



?C3 






.OD 


MOV 


1,4 




CI 


4,WA+60 



4.4.7.2 Insert (I). The Insert (I) command permits input of one or more lines following the pointer 
or a specified line. The syntax for the I command is as follows: 

I [<s>] 

As many Unes as required are entered. Each line is followed with a carriage return; the last line is 
followed with two carriage returns. When s is in the range of 1 to 9999, lines are inserted following 
Une s. When s is 0, lines are inserted ahead of the top line in the buffer. When s is omitted, lines are 
inserted following the pointer line. The following example shows the use of the I command to insert 
two lines following line 10: 

?I10 

CKON 
DEC 7 

4.4.7.3 Move (M). The Move (M) command moves a specified block of lines to a specified location 
and deletes the block of hnes at the previous location. The block is specified by first and last line 
numbers or by a number of lines preceding or following the pointer. The location to which the 
block will be moved is specified as a line number or as the pointer. The syntax for the M command 
is as follows: 

<s>-<t>, [<r>] 
M { [+] <n>, <r> 
- <n>, <r> 

Line s through line t are moved, or n lines with respect to the pointer are moved. When n is 
preceded by a minus sign, n lines preceding the pointer line, but not the pointer line, are moved. 
When n is unsigned or preceded by a plus sign, n lines beginning with the pointer line are moved. 

The specified lines are placed following line r when r is greater than zero. When r is zero, the 
specified hnes are placed ahead of the top line in the buffer. When r is omitted, the lines are placed 
following the pointer line, but r can only be omitted when specifying lines s through line t. Num- 
bered lines moved by the Move command retain their original line numbers, if any. When the 
pointer line is moved, the pointer moves with it. When s and t are specified, r must be less than s or 
greater than t. The following example shows an M command to move lines 6 through 8 to follow 
line 25: 

?M6-8,25 

The command in the following example moves four lines beginning with the pointer line to follow 
line 30: 

?M4,30 
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4.4.7.4 Remove (R). The Remove (R) command removes a block of lines. The block is specified 
by first and last line numbers, or by a number of lines preceding or following the pointer. The syn- 
tax for the R command is as follows: 

( <s> - <t> ) 

R <[+] [<n>]> 

Lines s through t are removed, or n Hnes with respect to the pointer are removed. When n is 
preceded by a minus sign, n lines preceding the pointer line, but not the pointer line, are removed. 
When no operand is entered, the pointer line is removed. When the pointer line is removed, the 
pointer is moved to the next line of the buffer. If the last line in the buffer is removed the pointer 
will point to the first line in the buffer. The following example shows an R command to remove 
line 12: 

7R12-12 

The command in the following example removes the three lines preceding the pointer line: 
?R-3 

4.4.7.5 Find (F). The Find (F) command scans a block of lines for the first occurrence in each line 
of the specified character string. Optionally, the command may replace the string with or without 
printing the resulting hne, or may print the line and permit the user to specify whether or not to 
substitute the string. In all cases, the command prints the count of matching lines found. The block 
is specified by first and last line numbers, or by a number of lines preceding or following the 
pointer. The syntax for the F command is as follows: 

<dlXstringlxdl> < '^' } 

(<d2>[<string2>]<d2>[Vl [P]) 

Line s through line t are scanned, or n lines are scanned. When n is preceded by a minus sign, n lines 
preceding the pointer Une, but not the pointer line, are scanned. When n is unsigned or preceded by 
a plus sign, n Hnes beginning with the pointer line are scanned. 

When an F is entered following the lines to be scanned, the columns specified in an SM command 
1^ are scanned for the first occurrence in each line. Columns 1 through 72 are the default scan columns 

unless the line is shorter than 72 columns, in which case it will scan to the end of the line. When an 
L is entered, the command performs a label scan, beginning at the left limit and extending to the 
first space. 

The character string used in the scan is designated stringl, and is enclosed by identical characters, 
each represented by dl. The character represented by dl may be any character that does not appear 
in stringl. 

When no other parameter is entered, the command scans the specified lines and prints the number 
of Hnes in which a match of stringl was found. When P is entered following dl, the command prints 
each hne in which a match of stringl was found, and also prints the number of lines in which the 
string occurred following the last line scanned. 

Character string, string2, enclosed by identical characters, each represented by d2, is the replacing 
f^^ string. String2 may be omitted, or may be longer or shorter than stringl. When the replacement is 
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made, the characters of string2, if any, replace the characters of string 1 and the length of the 
resulting line is adjusted as necessary. When there are no characters entered for string2, the char- ^,„^^,^^ 

acters of stringl are deleted. Character d2 may be any character that does not appear in string2, i 

V, or P. 

When no other parameter is entered following string2, the specified lines are scanned and string2 
replaces the first appearance on each line of stringl, or label stringl, each time a match is found. 
The command prints the number of lines in which the replacement was made after scanning the 
last line. 

Either V or P, or both, may be entered following string2. The verify operation, specified by V, 
prints the line in which the match is found, and prints the question Y/N? on the next line. The user 
must enter Y or N followed by a carriage return to continue the operation. When the user enters Y 
the replacement is made. When the user enters N the replacement is not made. The scan continues 
in either case. 

The print operation is specified by P. After the replacement is made, the resulting statement is 
printed and the scan continues. 

When, the specified lines have been scanned, TXEDIT prints the number of hnes in which a match 
was found. The pointer is left unchanged throughout the operation. 

The general rule of TXEDIT which allows spaces between characters or operands does not apply to 
stringl and string2. Any spaces between the characters represented by dl are considered part of 
stringl, and any sapces between the characters represented by d2 are considered part of string 2. 
Lines brought into memory have trailing balnks suppressed and therefore comparisons should not 
be made past the last non-blank character of a line. 

The following example shows an F command to replace the first appearance in each line of the 
string EUEN with the string EVEN in Hnes 34 through 48 and print the resulting lines: 

?F34^8F*EUEN*$EVEN$P 

The command in the followmg example verifies the replacement of label PI with string PUNl in 
each of nine lines beginning with the pointer line: 

?F9L'Pr'PUNrv 

4.4.8 PRINT COMMANDS. The print commands cause TXEDIT to print the first and last hnes in 
the buffer, or to print one or more specified lines. The print commands are described in the follow- 
ing paragraphs. 

4.4.8.1 Limits (L). The Limits (L) command causes TXEDIT to print the first and last lines m the 
buffer, including the line number, if any, with the right margin at column 72. The SN and SP com- 
mands do not affect the operation of the L command. The syntax for the L command is as follows: 



The L command is used to identify the top and bottom lines of the buffer. 

4.4.8.2 Print (P). The Print command causes TXEDIT to print a block of lines. The block of Hnes 

is specified by first and last line numbers, or by a number of hnes preceding or following the 

pointer. The SL and SN commands, when entered, control printing of line numbers, and the SP ^""^ 

command, when entered, sets the right margin of the print lines. When these commands are not 

entered, line numbers are printed and the right margin is column 72. The syntax of the P command 

is as follows. 

Change 2 4-12 Digital Systems Division 



^ 







946258-9701 



<s> - <t> 

rP [+] [<n>] 
-<n> 

Line s through line t are printed, or n hnes are printed. When n is preceded bv a minus sign, n 

lines preceding the pointer line, but not the pointer line, are printed. When n is unsigned or pre- 

^ ceded by a plus sign, n lines beginning with the pointer line are printed. When no operand is entered, 

the pointer line is printed. The following example shows a P command to print Unes 8 through 10: 

7P8-10 

The command in the following example prints the pointer line and the next three lines: 

?P4 

The user may terminate the Print command at any time by entering an ESC character at the key- 
board. TXEDIT then prints a question mark and awaits input of another command. 

C" 4.4.9 OUTPUT COMMANDS. TXEDIT provides two commands to write source or object code 

and one command to end execution of TXEDIT. The Keep (K) command writes the entire buffer 
or specified lines from the buffer. The Quit (Q) command writes specified lines from the buffer, 
the entire buffer, or the buffer contents and the remainder of the input file, and writes an end-of- 
file record on the output file. The output commands are described in the following paragraphs. 

4.4.9.1 Keep (K). The Keep (K) command writes a specified number of lines from the buffer to 
the output device. The syntax for the K command is as follows: 

K[<n>] 

The first n lines of the buffer, or all lines in the buffer when n is omitted, are written on the output 
file. When the pointer line is written, the pointer is moved to the top line remaining in the buffer. 
The K command is entered to write lines no longer required in the buffer in order to have space in 
the buffer for additional lines. The following example shows a K command to write the top 15 Unes 
of the buffer: 

?K15 

^ 4.4.9.2 Quit (Q). The Quit (Q) command writes lines from the buffer and input file followed by an 

end-of-file record. The syntax of the Q command is as follows: 

Q[<s>] 

The lines of the input file up to and including line number s are written. When line number s is in 
the buffer, lines are written from the buffer only. When hne number s is not in the buffer, TXEDIT 
writes the lines in the buffer, reads the additional lines from the input file, and writes these lines. 
If line number s is never found, the rest of the file will be copied. When s is zero the edit is finished; 
no more data is written from the buffer or from the file, and an EOF character is inserted in the 
output file. The Q command is used to truncate data. When s is omitted, the lines in the buffer 
and the remainder of the input file are written. The Q command is entered to write the output file, 
or the remainder of the output file, including the end-of-file record. After the lines have been 
copied to the output file, the terminate sequence is entered. 
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4.4.9.3 END (E). Another command available to initiate the terminate sequence is the End com- 
mand. This command ends the edit function without writing any data to the output file and does 
not cause the EOF character to be written. This provides an escape route from TXEDIT in the event 
a nonrecoverable error has been detected and there is no requirement to write an EOF on the out- 
put file. The system will respond to the E command with the TERMINATE/CONTINUE? prompt. 
Tlie user must then enter a T to exit from the TXEDIT program and restart without affecting the 
current status of the input or scratch files. 

4.4.10 TERMINATE-SEQUENCE COMMANDS. Two commands can be used to initiate a 
terminate sequence, depending on the particular situation. The normal method of terminating is 
with the Quit (Q) command, as explained above. The Q command always writes an EOF on the out- 
put file, and the system. responds with the following message: 

TERMINATE/CONTINUE? 

In response to this message, the user enters a T or C. When it is desired to reverse the flow of the 
data and continue the editing, the Continue (C) command is entered. The system responds with the 
question mark (?) prompt and editing continues, starting at line one, again. When editing is 
completed and the T response is entered for terminate, the system responds with one of two 
messages as follows: 

• TEXT IN INPUT FILE. 
END EDIT. 

or 

• TEXT IN SCRATCH FILE. 

TRANSFER TO INPUT? 

The first message, "TEXT IN INPUT FILE", ends the TXEDIT and returns control to the TXDS 
Control Program. If the second message, "TEXT IN SCRATCH FILE", is printed and the user 
enters a Y for yes, the text is transferred from the scratch file back to the input file and control is 
returned to the TXDS Control Program. If an N for no is entered, the system prints "END EDIT" 
and without any additional action, returns control to the TXDS Control Program. 

4.5 ERROR MESSAGES 

The TXEDIT error messages capable of being presented on the system console by TXEDIT, their 
reason for occurring, and the procedure for recovery from each error is presented in table 4-3. 

4.6 EXAMPLE: ENTERING A SOURCE PROGRAM ON A CASSETTE OR DISKETTE 

The following paragraphs describe the use of TXEDIT to enter a new source program on a cassette 
or diskette. The Insert (I) command is used to input new source statements. Any of the commands 
may be used to correct any errors made in entering the statements. Because statements entered 
with the Insert command have no line numbers, the pointer-relative specification is the only avail- 
able means of specifying a line in a command. 
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Message 
INVALID OPERATOR 

INVALID OPERAND 
BUFFER EMPTY 



/j^fc\ 



BUFFER FULL 



END OF FILE 



^^^ 



OFF THE TOP 



j^^^\ 



LAST LINE 



LINE NOT FOUND 



j^^^\ 



CANT GET MEMORY 



CANT GET COMMON 



Table 4-3. TXEDIT Error Messages 

Reason Recovery 

Enter a valid, correct command. 



The operator portion of a command 
entry is incorrect. 

The operand is not entered correctly or 
is beyond the range of values for that 
operand. 

A command that operates on data in the 
buffer is entered before data has been 
placed in the buffer from the input file 
or from the keyboard (either initially 
or after writing the entire buffer con- 
tents). 

A D, I, or C command has attempted to 
put more data into the buffer than the 
buffer can contain. 

End-of-file has been encountered on in- 
put or a D command has attempted to 
read more records than is contained in 
the input file. 



A negative displacement caused the 
pointer to be moved past the beginning 
of buffer. (That is, the negative dis- 
placement from the pointer line in a C, 
M, R, F, or P command is greater than 
the number of lines in the buffer before 
the pointer line.) 

A positive displacement caused the 
pointer to be moved beyond the last 
line at the end of the memory buffer. 

A line, or line number, was referenced 
but was not in the buffer. The first Une 
in a C, M, R, F, or P command, or the 
line number in an I command, or the 
destination line number in an M 
command is not in the buffer. 

Memory option was greater than avail- 
able memory. 

COMMON was not included at system 
generation time. 



Enter a valid, correct command or 
enter another command. 



Enter a D or I command and data. 



Enter a K command or write data 
from the buffer before entering or 
reading more data. 

Enter a Q command. Another edit- 
ing session may be entered by enter- 
ing a C to the TERMINATE/CON- 
TINUE? question. TXEDIT will 
make no further attempt to read the 
input file until the program restarts. 

After printing the message, TXEDIT 
is positioned at the top (i.e., first) 
line of the buffer. 



TXEDIT prints a question mark and 
waits for another command. 



The command is not executed by 
TXEDIT. Enter another command in 
response to the question mark (?) 
prompt. 



Enter a smaller memory option. 



Execute the system generation utility 
and include COMMON. 
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Message 

nn - I/O ERROR (where 
nn refers to the error code 
listed in Appendix I, en- 
titled "I/O Error Codes"). 

NAMES CANNOT BE 
THE SAME 

ILLEGAL PARAMETER 



TRANSFER I/O ERROR 



I/O ERROR, RETRY? 

(Y,N,orCRtoabort 
I/O) 



Table 4-3. TXEDIT Error Messages (Continued) 

Reason Recovery 

There was an I/O error. Correct error and restart. 



^ 



The input file name entry and the output 
file name entry were the same. 

The file name was not included in the 
INPUT: parameter. 

There was an I/O error transferring the 
output file to the input file. 

If "Y" is entered, it will backspace one 
record and try to read that record again. 
If "N" is entered, it will try to read the 
next record. If a carriage return (CR) 
is entered, the text editor will terminate. 



Reenter INPUT: and OUTPUT: 
parameter. 

Reenter the INPUT: parameter. 



Correct and use the TXCCAT utility to 
copy the output file to the input file. 



^ 



The following text describes an example of writing a source program using TXEDIT. 
The initial message and the first command, with associated entries, are as follows: 

TXEDIT 936220** 

?I0 

Wl BSS 32 

START RSET 

LWPI Wl 

CLE RO 

The I command with an operand of zero causes TXEDIT to place the lines that follow at the top 
of the buffer. The buffer pointer is not moved as lines are entered and remains ahead of the first 
line entered. In the above example, an error was made in the operation field of the fourth line, so 
the user entered an additional carriage return to terminate the command, permitting entry of 
another command to correct the error. 

The next part of the example program is: 



^^"^ 



?K3 
?P1 



CLE 



RO 



The K command causes TXEDIT to write the first three lines on the output medium. The PI 
command causes TXEDIT to print the pointer line to verify that the pointer is at the line that 
contains the error. An alternative to using the Keep command to write the correct portion of the 
program is to use a Down (D) command to position the pointer for correction of the error, leaving 
the first three lines in the buffer. 



~) 
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j^^m^!\^ 



^^\ 



r 



j^^^^ 



/^^^ 



The next command and the associated entries are as follows: 
?C 
II 
Dl 



CLR 


RO 


INC 


RO 


JNO 


Jl 


DEC 


RO 


JNE 


Dl 


JMP 


11 


END 


START 



The C command deletes the error line and accepts seven lines of source code. The example source 
program is now complete, with three lines written on the output medium, and seven lines in the 
buffer. 

The next command and the resultant printout or display follows: 

?F10F'J1"I1' 
LAST LINE 
0001 FOUND 

The F command scans the contents of the buffer, replacing the first appearance in each Hne of 
string Jl with string II. The command attempts to scan 10 lines,and prints the message "LAST 
LINE" because there are only seven lines in the buffer. The V and P options (described above under 
the Find (F) command paragraph) could have been used. This is an alternate method of correcting 
an error in a source program entered from the keyboard using TXEDIT. 

The next command and the resultant printout or display follows: 



?P10 




CLR 


RO 


1 INC 


RO 


JNO 


11 


)1 DEC 


RO 


JNE 


Dl 


JMP 


11 


END 


START 


AST LINE 





The P command causes TXEDIT to print the contents of the buffer and the last line message. 
Entering the Quit command causes the terminate sequence to be entered. I 

?Q 
TERMINATE/CONTINUE? ■ 

The Q command causes TXEDIT to write the buffer contents on the output medium following the 
records previously written by the Keep (K) command. An end-of-file record is written following the 
last record. The user then enters a T to terminate the text editor, and a Y to transfer the scratch file 
to the original input file. 

TERMINATE/C0NTINUE7T 
TEXT IN SCRATCH FILE. 
TRANSFER TO INPUT7Y 
END EDIT 
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4.7 EXAMPLE OF HOW TO EDIT A SOURCE PROGRAM ^ 

The capabilities of TXEDIT to edit source programs include adding, moving, and removing state- 
ments, and replacing a character string in statements. The edited program may include portions of 
a number of source programs. The purpose of editing is to correct or modify a source program. 
The following paragraphs describe an example of editing a source program and considerations for 
editing source programs. For this example, a typical source program is used for which no Setup 
command is required because default values for print margin and F command limits are used and 
line numbers are printed. 

The initialization messages and the first command are as follows: 

TXEDIT 936220 ** 

?D117 

The D command moves the pointer down 1 1 7 Hnes, and TXEDIT reads in the source file to fill the 

buffer as defined by the D command. A smaller value could have been used to read part of the file, ,^ 

followed by a subsequent D command to read the remainder. Had a larger value been entered, 

TXEDIT would have read the 1 17 records of the file and printed the end-of-file message. TXEDIT 

prints the prompt character (?) and awaits another command. 

The next command and printout result are as follows: 

?L 

000 1 TITL 'EDITING EXAMPLE' 
0117 END 



•^ 



The L command verifies the buffer contents by printing the first and last lines in the buffer. Had 
the SN and SP commands been entered, they would not have affected the printing of the limits 
resulting from the L command. 

The next command is as follows: 

?T 

The T command moves the pointer to the top of the buffer (line 1) from line 1 17 where the first 
command had placed the pointer. Moving the pointer to the top of the buffer permits using pointer- 
relative commands for the area at the top of the buffer. 

The following commands move line 46 to a position after line 116 and remove line 117. 

?M46-46,116 
7R117-117 

The following command is entered. 

?M81-87,115 



,^ 



•^ 
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This M command moves lines 81-87 to a position following line 1 15 to cause the line numbers in 
/^^ the buffer to be out of sequence. 

The following commands prepare the move operation for verifying. 

?B 

?P1 

0046 END START 

The B command places the pointer on the last line of the buffer, and the P command prints the 
pointer line to verify that it is on the proper line. 

The next command and the resultant printout or display on the system console are presented as 
follows: 



iP^^ 



?P-13 






0111 


UP2 MOV 


*R10,*R10 


0112 


JNE 


UPl 


0113 


BL 


@A110P 


0114 


MOV 


*DUMNXT,TMLOC 


0115 


JMP 


UP3 


0081 


*ROUTINE COMMON TO UP AND DO) 


0082 


UDCOMl MOV 


RTN,R5 


0083 


BL 


@SCANOP 


0084 


INC 


UDCNT 


0085 


MOV 


UDCNT.UDCNT 


0086 


JEQ 


EXIT 


0087 


B 


*R5 


0116 


* 





The P command prints the 13 lines preceding the pointer line, and the result shows that lines 81-87 
have been placed after line 115. This result also shows the effect of the previous move and remove 
commands. 

The next command and associated entries are as follows: 



?I77 






*TITLE = 
MSGOUT 


MSGOUT 

MOV 

MOV 

BLWP 

B 


MESSAGE OUTPUT 

*R11,*R10 

@MCOUNT(R10),R10 

©PRINT 

*R11 



The I command inserts five hues following line 77. The number of lines inserted is the number of 
lines entered with the command and may be one or more lines. After the carriage return that 
terminates the last line, an additional carriage return is entered to terminate the command. 
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The next command and resultant printout are as follows: 



QQll 



^ 



*TITLE= 
MSGOUT 



0078 EOFEXT 



JMP EXIT 

MSGOUT MESSOUT OUTPUT 

MOV *R11,*R10 

MOV @MCOUNT(R10),R10 

BLV/P ©PRINT 

B *R11 

BL @MSGOUT 



The P command prints lines 77 through 78, which includes the five unnumbered lines inserted by 
the previous command. The result shows that the lines have been inserted correctly. 

The next command and the resultant interaction are as follows: 



?F 1-46F'EXIT"EXTDWN'VP 



0071 
Y/N? 
0071 
0077 
Y/N? 
0077 
0080 
Y/N? 
0080 
0086 
Y/N? 
0004 



EXIT 



JMP 

JMP 

JMP 

JMP 
RTWP 



EXTDWN RTWP 
JEQ 
N 
FOUND 



EXIT 

EXTDWN 
EXIT 

EXTDWN 



EXIT 



The F command fmds the first appearance in a line of the string EXIT in lines 1 through 46. 
(Remember that line 46 is now the last line, i.e., after line 116.) The entire buffer is scanned 
because the top line in the buffer is line 1 and the bottom line is line 46. Line numbers greater than 
46 between lines 1 and 46 are also scanned. The replacing string is used only when the user enters 
a Y following the printing of the line found. In the example shown, the replacement was not made 
in line 86 because the user entered an N following the printing of this line. Lines 7 1, 77 and 80 were 
replaced because the user entered a Y following the printing of these lines. The count of lines found 
is printed after all lines have been scanned. The F command may be used to scan only a portion of 
the buffer, from one line up to the entire buffer, and replace from one character to the entire 
statement. 

The next three commands are as follows: 

?R15-15 
?R17-17 
?R19-19 

Each R command removes the specified line from the buffer. Three commands that remove one line 
each are necessary because the lines to be removed are not consecutive. A single R command may 
remove one or more consecutive lines. 



^««%, 
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d^\ 



j^^^ 



yj^^\ 



The next command and the resultant printout are as follows: 



7P14-20 








0014 


DUMNXT 


EQU 





0016 


LINAD 


EQU 


2 


0018 


LINPTR 


EQU 


4 


0020 


CLLOC 


EQU 


6 



The P command prints Hnes 14 through 20. The result shows that the lines specified in the Remove 
(R) command were removed. 

The next command is as follows: 

?U2 

The U command positions the pointer to the second Une preceding the pointer line. The pointer 
could have been moved any number of lines up to the top of the buffer. 

The next two commands, the resultant printout of the first command, and the entry associated 
with the second are as follows: 

7P68-68 

0068 A @MAXLIN,UDCNT 

7C68-68 

A @MINLIN,UDCNT 

The P command prints Hne number 68 to verify that line 68 is the desired line. The C command 
changes line 68 to the Hne entered with the command. One or more consecutive lines may be 
deleted by a C command, and any number of lines, including zero lines, may be added. The number 
of lines added does not have to be equal to the number of lines deleted and the added lines have no 
line numbers. 

If there were no more data in the input file, or if the remaining data were to be discarded, the next 
command would be ?Q1 17. This would place the data in the buffer in the SCRATCH file and place 
an EOF at the end of the data. If, however, there were more data in the input file but no editing 
was required, the next command would be just ?Q. The Q command would write the entire buffer, 
plus whatever was remaining in the input file would be placed into the scratch file and EOF would 
be placed at the end. 



The next response from the system would be as follows: 



TERMINATE/CONTINUE? 



If no 
follows: 



further editing is desired, the operator enters a T for terminate. The system would respond as 

/s: 

TEXT IN SCRATCH FILE. 
TRANSFER TO INPUT? 

At this point the operator decides where the text is to reside. If a Y is entered for Yes, the scratch 
file text is transferred directly to the input file, or if N is entered, the text remains in the OUTPUT 
file. The system ends the TXEDIT by printing END EDIT and the TXDS control program is reacti- 
vated. 
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4.8 EXAMPLE OF HOW TO EDIT AN OBJECT PROGRAM 

The capabilities of TXEDIT to edit object programs include adding, moving, and removing records, "^ 

and replacing a character string in records. These capabilities allow the user to combine object code,' 

correct object code, and add object code at the machine instruction level. In editing object code, it 

is necessary to thoroughly understand the object code format and the significance of tag characters 

(described in the Model 990 Computer/TMS9900 Microprocessor Assembly Language Programmer's 

Guide). Records may be inserted into an object program at any point except that the records that 

contain tag character 3 or 4, tag character 5 or 6, and tag character 1 or 2 must follow all other 

records in the object file. Further, the record that contains tag character D, if any, must precede 

the record that contains the first tag character 0. Each record must end with tag character F. When 

the contents of a record are altered, tag character 7 and associated field must be removed. 

When the length of relocatable code is increased, the contents of the hexadecimal field associated 
with the final tag character must be changed. The following paragraph describes an example of 
editing an object program. 



^ 



-'^"^ 



NOTE 

Compressed object code cannot be edited. 

In the example, the purpose of the edit is to add a record to specify a load point, to change instruc- 
tions that use workspace register 1 to use workspace register 7 instead, to change an instruction, and 
to add an instruction. 

The initiaUzation message and the first command are as follows: 

?SN 

The SN command is a setup command that inhibits printing of line numbers. When line numbers are 
printed, printing of an object record may be truncated because of the length of the print line. 

The next command and the associated entry are as follows: 

?I0 
DIOOOF 

The I command with an operand of inserts the associated line at the top of the buffer. The line ^^ 

will be the first record in the edited object file, and contains load point of lOOOie, specified with a 
D tag character. 

The next command and the resultant printout are as follows: 

?D10 

END OF FILE 

The D command causes TXEDIT to read in the object file to be edited. The file contains six 
records, so the operand used causes TXEDIT to attempt to read past the end-of-file record. This 
inhibits further reading of any input file in this run of TXEDIT. 
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The next command and the resultant printout are as follows: 

?L 

DIOOOF 
0006 200CE10010C 7FCABF 

The L command causes TXEDIT to print the limits. The top line in the buffer is the line entered 
with the I command, and has no line number. The bottom line is the last line of the object file, 
line 6. 

The next command and the resulting interaction are as follows: 

?F1-6F'BG002"B000E'VP 

OOOOOSAMPROG 90040C0000A0020BC06DB000290042C0020A0024BC81BC002A7F219F 
Y/N?Y 

OOOOOSAMPROG 90040C0000A0020BC06DB000E90042C0020A0024BC81BC002A7F219F 

A0028B0241B0000BCB41B0002B0380A00CAC0052C00A2B02E0C0032B0200B0F0F7F1DEF 

Y/N?Y 

A0028B0241B0000BCB41B000EB0380A00CAC0052C00A2B02E0C0032B0200B0F0F7F1DEF 
0002 FOUND 

^p^ The F command scans for the character string B0002 with the verify and print options. The replace- 

C ment string, BOOOE, changes the memory address of workspace register 1 to that of workspace 

register 7 in two instructions. Verification and printing provides control and documentation of the 

changes. 

The next command and the resulting interaction are as follows: 
?F1-6F'7F151"'VP 

A00D6BC0A0C00CAB04C3BC160C00CCBC1A0C00D0BC1F2B0287B3A00A00ECB02217F151F 
Y/N?Y 

A00D6DC0A0C00CAB04C3BC160C00CCBC1A0C00D0DC1F2B0287B3A00A00EB0221F 
0001 FOUND 

The F command scans for the character string 7F151, which is a checksum tag character and 
associated field. The replacement character string is a null string, and the result is to remove the 
checksum from a record which was changed by an edit command not shown here. 

The next command and the associated entry are as follows: 

?I 
AOOECB0227AOOFOB06C7A010AB04CTF 
AOIOCBIOFFF 



/p^^ 



r^ 
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The I command inserts the associated two Hnes following the line on which the pointer had been 
positioned by an edit command not shown. The first hne will cause the loader to overlay three 
words of the original file, which is another way of changing object code. The second line is an added 
instruction which will increase the size of the program module. 

The next three commands, the resultant printout of the second, and the associated entry of the 
third are as follows: 

?D3 

?P1 

200CE0010C 7FCABF 

?C 
200CE0010E F 

The D command moves the pointer line down three lines, and the P command causes TXEDIT to 

print the pointer line to verify the pointer position. The C command changes the pointer line to >^ 

modify the number of words of relocatable code in the program. If this is not done, and another 

module is loaded following this module without specifying a load address for the subsequent 

module, the subsequent module will overlay the instruction that was added. The pointer line is also 

changed to delete the checksum. 

The last command and the final messages are as follows: 

?Q 
TERMINATE/CONTINUE ?T 

The Q command causes TXEDIT to write the contents of the buffer and any data remaining in the 
input file, followed by an end-of-file record, on the output medium. The T command causes 
TXEDIT to terminate and issue the message: 

TEXT IN SCRATCH FILE. 
TRANSFER TO INPUT? 

If all editing is completed, the user responds with a Y (yes) and TXEDIT transfers the scratch file 

to the input file and prints "END EDIT". ,^ 

1 



x^ 
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SECTION V 
ASSEMBLING SOURCE PROGRAMS 



>^Wk^ 



J^^^^\ 



/^»K^ 



5.1 INTRODUCTION 

The TXMIRA Utility Program is a member of a family of assemblers that may be used with the 
Model 990 Computer family. It functions to substitute absolute operation codes and addresses 
(i.e. Model 990 machine language) for symbolic codes and addresses (i.e. assembly language 
source code programs). TXMIRA provides for the allocation of storage to the minimum extent 
of assigning storage locations to successive instructions and for the computation of relocatable 
addresses from symbohc addresses. The TXMIRA program has the following features: 

• Assembles all 72 instructions for both the Model 990/4 and the Model 990/10 
Computers 

• Supports many assembler directives 

Supports program, data, and common segmentation 

Supports both pseudo instructions (NOP,RT) 

Supports a sorted symbol list option 

Provides error messages in text form 

Supports compressed object code 

Prints or truncates 'TEXT' string option 

Assembles FORTRAN compiler source output 

As a two-pass assembler program, TXMIRA reads the program source statements two times, pro- 
viding maximum programming flexibility in the process of producing object code. On the first pass, 
the assembler maintains the location counter and builds a symbol table similar to those in a one-pass 
assembler. During this pass some errors may be detected and printed on the listing device. For the 
second pass, the source statements are read in again by rewinding the input file. During 
the second pass, the assembler generates the object code using the symbol table developed during 
the first pass. The two pass feature reduces the restrictions on forward referencing. TXMIRA 
produces a listing of the source code and the object code (i.e., machine language). Optionally, the 
assembler prints out the symbol table. Further, the resultant output produced by the TXMIRA 
utility program may be linked to other output modules or be loaded separately for execution. 

For more details on the Model 990 assembly language, refer to Model 990 TMS9900 Microprocessor 
Assembly Language Programmer's Guide, part number 943441-9701, 

5.2 LUNOs AND THEIR USES 

LUNOs 5, 6, and 7 are used by TXMIRA program for source input, object output, and Hsting, 
respectively. All LUNOs are assigned by the TXMIRA program. Upon termination of the TXMIRA 
program, all LUNOs are released. 
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5.3 OPERATION INTERACTION 

The TXMIRA program can only run under the control of the TXDS Control Program. The INPUT: ^1 

parameter must have the pathname of the source file to be assembled. The first OUTPUT: param- 
eter must have the pathname of the file or device to which the object code will be written. The sec- 
ond OUTPUT: parameter must have the pathname to which the listing will be written. The object 
pathname and the listing pathname must be separated by a comma. If the output file does not 
exist, it will be created as a sequential file with the name given. If the listing pathname is null, 
the system default printer will be used. If only part of the listing pathname is used, the defaults in 
table 5-1 will be used. The following is an example of loading and executing TXMIRA using the 
TXDS Control Program. 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



TXMIRA/SYS 

SOURCE 

OBJECT,LP 

SLM4000 



5.4 TXMIRA OPTIONS 

The TXMIRA assembler options are specified by a single alphabetic character followed in one 
case, M, by a numeric field. Input format is free-form in that delimiters (i.e. separators) may be 
commas, blanks or no delimiters. The options recognized by TXMIRA are hsted and described 
in table 5-2. These options are described further in the following subparagraphs. 





Table 5-1. Pathname Defaults 




Field 


Source Object 


Listing 


DEV 


DEFAULT DISC NAME DEFAULT DISC NAME 


DEFAULT DISC NAME 


FILE 


NONE SOURCE FILE 


SOURCE FILE 


EXT 


SRC OBJ 


LST 



Table 5-2. TXMIRA Options 

Option Description 

Mnnnnn Overrides memory size default; default is 

2400 bytes 

X Produce cross-reference 

L Produce assembly listing 

T Expand TEXT code on listing 

S Produce sorted symbol list 

C Produce compressed object output 

R Predefine registers ^**^ 

where n is a decimal digit 
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5.4.1 MEMORY OPTION (M). The memory option is used to override the default memory size. 
[^ The size is expressed in bytes. The syntax of the option is as follows: 

Mn (where n is a decimal number up to five decimal digits) 

Some examples follow: 

M4096 
M20000 
MO 1000 

5.4.2 CROSS-REFERENCE OPTION (X). This option is used when a cross-reference is desired. 
Upon termination of TXMIRA, the TXDS Control Program will chain to the TXXREF Utility 
Program (described in Section VI) to perform the cross-reference operations. To enable the cross- 
reference option to work properly, the TXXREF object code must be in a file with the following 
pathname: 

:TXXREF/SYS 

5.4.3 LISTING OPTION (L). This option is used when a listing is desired by the user. It may be 
overriden by the LIST and UNL assembler directives. Errors are always printed. 

5.4.4 PRINT TEXT OPTION (T). This option is used when expansion of TEXT statements is 
desired by the user. Default results in no expansion of TEXT statements. 

5.4.5 SYMBOL TABLE LISTING OPTIONS(S), This option is used when a sorted symbol list 
•output is desired. The list presents four symbols to a line; and each symbol presents the following 
information in sequence: (1) attribute tag; (2) symbol; and (3) value. Table 5-3 defines the symbols 
used in the listing. 

5.4.6 COMPRESSED OBJECT OPTION (C). This option is used when compressed object code is 
desired, and it may only be written to a diskette file. Compressed object takes up less diskette 
space. See Appendix B for a description of compressed object. 

5.4.7 PREDEFINE REGISTERS OPTION (R). This option is used to predefine the register 
symbols used in a source program, equating the symbol RO with workspace register 0, Rl with 
register 1, R2 with register 2, . . . R15 with register 15. 

Table 5-3, Symbol Attributes 
Character Meaning 

Data Relocatable 
+ Common Relocatable 

Program Relocatable 
E External Reference (REF) 

D External Definition (DEF) 

X Extended Operation (XOP) 

U Undefined 

S Secondary Reference (SREF) 



i^w\ 



i#*^ 



I 
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5.5 ERRORS 

5.5.1 TXMIRA ERROR MESSAGES. The TXMIRA assembler processes fatal errors (table 5-4) 
and nonfatal errors (table 5-5). The fatal errors cause the run to abort with the appropriate error 
message printed. 

The nonfatal errors do not cause the run to abort. An error message is printed following the state- 
ment containing the error. The format of the printout is as follows: 

***** SYNTAX ERROR - RCD nnnn 

where nnnn is the source record number. 

When there are undefined symbols in an assembly, the undefined symbols are listed at the end of 
the assembly listing under the following heading: 

THE FOLLOWING SYMBOLS ARE UNDEFINED: 



Table 5-4. TXMIRA Fata Errors 
Description 

COMMON not in system 

MEMORY size requested too 
large 

MEMORY size too small 

END directive missing 

PATHNAME syntax is incorrect 

I/O ERROR on A, where A 
can be : 

S=SOURCE 

0=OBJECT 

L=LISTING 

Error in Assign or Open 
Error in Close 



Error 

CANT GET COMMON 
CANT GET MEMORY 

SYMBOL TABLE 
OVERFLOW 

NO END CARD FOUND 

nn-ILLEGAL PATHNAME 

nn-I/0 ERROR A 



Recovery 

Re-Gen system with COMMON 
Decrease request 

Increase request 

Add directive and reassemble 
Correct pathname and retry 
Correct and retry 



nn-ASSIGN ERROR 
nn-CLOSE ERROR 

Note: nn is a system returned error code. See Appendix D for explanation 



Correct pathname and retry 
Correct pathname and retry 



^ 



^ 



^ 



^ 



Change 3 



5^ 



Digital Systems Division 




946258-9701 



Table 5-5 . TXMIRA Nonfatal Errors 

***** SYNTAX ERROR - RCD nnnn 

***** ILLEGAL EXTERNAL REF. - RCD nnnn 

***** VALUE TRUNCATION - RCD nnnn 

***** MULTIPLY DEFINED SYM - RCD nnnn 

***** INVALID OPERATOR - RCD nnnn 

***** ILLEGAL FORWARD REF. RCD nnnn 

***** ILLEGAL TERM - RCD nnnn 

***** ILLEGAL REGISTER - RCD nnnn 

***** SYMBOL TRUNCATION - RCD nnnn 

***** UNDEFINED SYMBOL - RCD nnnn 

***** COMMON TABLE OVERFLOW - RCD nnnn 

***** PEND ASSUMED - RCD nnnn 

***** DEND ASSUMED - RCD nnnn 

***** CEND ASSUMED - RCD nnnn 

1^ where nnnn is the record number in which 

the error occurred 

5.6 TXMIRA EXAMPLE 

Following is an example of loading and executing TXMIRA. The diskette file :TXTST1/SRC is 
entered in the INPUT: source file parameter line. DSC2: is entered in the first OUTPUT: parameter 
causing TXMIRA defaults for the file name and extension. Therefore, the object (machine) code 
is written to the diskette file DSC2:TXTST1/0BJ. LOG is entered in the second output parameter 
producing the source listing output on the system console. Two options are entered in the 
#**^ OPTIONS: parameter line. The L option produces a source listing, and the S option produces a 

symbol table. 

Tl-inS 3.36£l"l:5 ♦H l." 00: 01 

PRaCiRrlM : : T'An I Rfi -S V::: 
INPUT: :T:==;T:2T1.-:::RC 
aUTPiJT: DSCa: M_0i3 

nPTinm: l>::: 

J>'.iMP.il 9:3rSc'c:7 ♦♦ 
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Following is an example of the source listing caused by entering an L in the OPTIONS: parameter 
line. 



^""^ 



rXTSTI TXNIRR 936227 ■^^■^■^^ 
l/.US TEST PROGRRM 937308-9901** 



PRGE 0001 



0002 

0003 * 

0004 

0005 * 

0006 0000 0006 ' 
0002 0045 * 
0004 0000 

0007 0006 TSTWSP BSS 32 

0008 0026 1600 ENDPRG DRTR >1600 



IDT -^TXTSTl' 

REF CNT.. NEW.. WRITE 

DRTR TSTWSP.. STRRT.. 



0009 






:+: 






0010 








DKOP 


SVC 15 


0011 






+ 






0012 


0028 

0029 

002fl 


0D 
0FI 
0R 


OLD 


BVTE 


>0D.. >0fl. >0fi 


0012 


002B 


20 




TEXT 


••• OLD MESSfiGE 


0014 


0042 
0044 


0D 

01=1 




BVTE 


>0D.. >0fl 


0015 




001D 


Cr-4T1 


EQU 


*-OLD 



END OF PROGRRM OP CODE 
*** DEFINE KOP 

WRONG ! ! •• 



^ 



TXTSTl TXMIRR 936227 ** 

TXDS TEST PROGRRM 937808-9901** 



PRGE 0002 



0017 

0018 0046 0420 
0Gi48 00H10 

0019 004R 0G128 
004C 0G11D 

0020 004E 2FE0 
0050 0026 * 

0021 



STRRT 



BLWP ©WRITE 
DRTR OLD.. CNTl 
SVC 0ENDPRG 
END 



PRINT MESSRQE 



END OF PROGRRM 



Following is an example of the sorted symbol table caused by entering an S in the OPTIONS: 
parameter line. 



TXTSTl TXMIRR 936227 *R 
TXDS TEST PROGRRM 927808-9901** 



E CNT 0000 
^ OLD 0028 
E WRITE 0048 

0000 ERRORS 



CNTl 001D 
STRRT 0045 



' ENDPRG 0026 
X SVC 000F 



PRGE 0001 



E NEW 0000 
' TSTWSP 0006 



/^^ 



/S^^ 



>!<S*V 



Change 3 



5-6 



Digital Systems Division 




946258-9701 



/^^\. 



^^\ 



J^^\ 



/^^^\ 



SECTION VI 

\ 

TXDS CROSS-REFERENCE (TXXREF) UTILITY PROGRAM 

6.1 INTRODUCTION 

The TX990 Cross Reference (TXXREF) Program is a single pass cross-reference program. The pro- 
gram gives a listing of each user-defined symbol in a 990 assembly source program along with the 
line numbers on which the symbol is defined and all of the line numbers on which the symbol is 
referenced. The Hne numbers of the references to a symbol are in ascending order, and the symbols 
are in alphabetical order. If the symbol was never defined, only the line numbers of the references 
to the label will be listed. 

6.2 LUNOs 

LUNOs 5 and 6 are used by TXXREF. They are assigned when execution begins and released upon 
termination by the program. LUNG 5 is the source input LUNO, and LUNO 6 is the listing LUNO. 

6.3 OPERATING PROCEDURE 

TXXREF can only run under the control of TXDS. The object program may be loaded from a 
device or from the file, :TXXREF/SYS. 

The INPUT: parameter must contain the pathname of a source program. The OUTPUT: parameter 
must contain the pathname of a listing device to which the cross-reference listing will be directed. If 
there is no response to the OUTPUT: prompt, the default print device will be used. 

The pathname defaults are given in table 6-1. The input file must preexist, and if the output file 
does not exist, it is created with the name given. Lastly, an option may be entered to override the 
symbol table size. 

6.4 LISTING FORMAT 

An example of a Hsting is shown in figure 6-1 . The heading gives the name and version of TXXREF 
and the time and date of the run, if the time and date are initialized. Each line of the cross-reference 
begins with the symbol, listed alphabetically, followed by the line number on which it was defined 
(appearance in the label field), if any, and the list of line numbers, in ascending order, on which the 
symbol was referenced, if any. The last line gives the number of symbols in the cross-reference. 

NOTE 

If TXXREF runs out of table space, it prints the references found at 
that point, and attempts to continue. If insufficient space was freed 
up by that process, then TXXREF terminates. 





Table 6-1 . Pathname Defaults 




Field 


Input 


Output 


DEV 


SYSTEM DISC 


SYSTEM DISC 


FILE 


NONE 


INPUT FILE 


EXT 


SRC 


LST 
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^"^Sv 



TMXREF i 


?.1;?542 *■■+• 10 : 2 


i:2:36 


088,- 


•■?? PAGE 000J 


RSREXT 




01?5 


01?6 








flSRHflH 




016? 


0168 








BAD 


0283 












BAD I NT 




0243 


0285 








BUFi 


0089 


0149 










BUF2 


0105 


0150 










BIJF3 


0124 


0151 










BUFRDH 


0143 


0064 










BUFflDL 


0066 


0064 










BUFE 


0152 


0146 










BUFF 


0148 


0146 










BUFH 


014? 


0146 










COHSIZ 


0239 


0238 










CRTHflN 




0229 


0230 








DFLDSC 


0060 


0059 










DFLPTR 


0061 


0059 










DHT 


0039 


0038 










DNT2 


0040 


0038 










DNTEHD 


005? 


0038 










FMPBUF 


0155 


0154 










FPVDCD 




02?4 


0275 








FPVDSR 




0197 


0198 


0213 


0214 




FPVINT 




0200 


0201 


0216 


021? 




FPVSPR 




0193 


0194 


0209 


0210 




FREQK2 


0004 


0003 


0005 








GO 




01?0 


01?1 


0266 


026? 




Q0913 




0232 


0233 








IDL915: 




0225 


0226 








ILLSVC 




0021 










KB IDLE 




0163 


0164 








KBTfiB 


002? 


0026 










KSBl 


0033 


0029 


0224 


0251 






KVBIN 




0250 


0251 








KVBUT 


0028 


0026 


0031 


0032 






LDTSTR 


0065 


0064 










LEVI 


0246 


0290 










LEV4 


0254 


0291 










LEV6 


0262 


0292 










LEV? 


02?0 


0293 










L0C3 


0249 


024? 










L0C4 


025? 


0255 










L0C6 


0265 


0263 










LOC? 


02?3 


02?1 










LPHfiN 




0184 


0185 








LP I NT 




018? 


0188 


0258 


0259 




LPSPUR 




0180 


0181 








LVLPTR 


0013 


0012 











"^ 



-^ 
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r 



MflXST2 


0032 


0026 








MflXSTfi 


0031 


0026 








PDT0 


0160 


0041 


0043 


0045 


0078 


PDT3 


0177 


0047 


0160 


0259 




PDT4 


0190 


0049 


0068 


0177 


0276 


PDT5 


0206 


0051 


0073 


0190 


0277 


PDTe 


0222 


0053 


0206 






PDTSTR 


0159 


0158 









0083 0267 



TXXREF 


937542 ** 


10: 


32:36 


PWRFLQ 


0010 


0009 




RET 


0284 


0248 


0256 


SLICE 


0006 


0003 




STINTR 


0005 


0003 




TRSKCM 


0240 


0238 




TRFIBfiD 


0285 


0283 




TRflPRT 




0243 


0284 


TRPINT 


0289 


0288 




TXSTR3 




0007 


0008 


UMKSVC 


0023 


0020 




USCTflB 


0022 


0020 


0023 


WSP3 


0244 


0290 




WSP4 


0252 


0291 




WSP6 


0260 


0292 




WSP7 


0268 


0293 




XWP4 


0276 


0192 


0208 


XWS 




0243 


0285 



088/77 



0264 02T 



PAGE 0002 



THERE RRE 0072 SVMBOLS 



j^^\ 



Figure 6-1. Sample Cross Reference Listing (Abbreviated) 
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6.5 OPTIONS 

The only option that is recognized by TXXREF is the memory-size-override option. The size is 
given in bytes. The option is as follows: 

Mnnnnn where n is a decimal digit. 

The following are examples: 

M4096 

M00200 

M2000 

The default memory size is 4800 bytes. The memory block is used to build a symbol table. There- 
fore, the size must be at least 12 times the number of symbols in the source program, plus 4 times 
the number of references. 

6.6 ERROR MESSAGES 

The errors, descriptions and recovery for TXXREF are listed in table 6-2. 



^ 



-^ 



Error 
CANT GET COMMON 

CANT GET MEMORY 

nn - ILLEGAL PATHNAME 

nn - I/O ERROR 

INSUFFICIENT MEMORY - 
ABORT 

nn - ASSIGN ERROR 
nn - CLOSE ERROR 



Table 6-2. Error Messages 

Description 

System COMMON not in 
system. 

Memory request too large 

Pathname doesn't exist or 
open error 

Error on read or write 

Symbol table exceeded 
memory 

Error on Assign or Open 
Error on Close 



Recovery 

Regenerate system with 
COMMON 

Decrease size 

Correct name and retry 

Retry 

Increase memory 
request 

Correct pathname and retry 
Correct pathname and retry 



^ 



^ 
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SECTION VII 
LINKING OBJECT MODULES 



7.1 INTRODUCTION 

In order to link separate object modules together to form a complete program, the user must 
execute either the Link Editor or the TXDS Linking Utility Program. (TXLINK). For linking 
FORTRAN programs or tasks and procedures, the Link Editor must be used; TXLINK does not 
support FORTRAN or procedures. 

The output of both the Link Editor and TXLINK is a file with a linked object module. The Link 
Editor can also create program files (see Section I of the TX990 Operating System Programmer's 
Guide) as output. 

The Link Editor is discussed in the Model 990 Computer Link Editor Reference Manual part 
number 949617-9701. TXLINK is discussed in the following paragraphs. 

TXLINK accepts standard Model 990 object code modules (described in the Model 990 Computer 
TMS 9900 Microprocessor Assembly Language Programmer's Guide, part number 943441-9701, 
and compressed object code, available as an option (illustrated in table 6-3) and links the modules 
according to command information supplied by the user and the linking information in the modules. 
The linked output module is written on the output file. 

Linking allows a set of independently assembled object modules to be linked to form a single object 
module. The major linking function is the resolution of external references and definitions in the 
individual unlinked modules. 

TXLINK also supports partial linking of modules. A partially linked module may be used as input 
to another run of TXLINK with additional modules that satisfy the unresolved references. 

The following restrictions apply : 



• 
• 



Linking of modules having absolute original addresses (AORG directive) is not supported. 

There must be enough memory for all symbols, (12 bytes/symbol), IDTs (24 bytes/IDT) 
and twice the length of the longest module to be linked. Memory size is defined by the 
"M" option. 

• TXLINK only recognizes object tags "0" through "F". 

-a 

• TXLINK does not link FORTRAN programs or tasks with procedures. 

7.2 TXLINK FILE STRUCTURES AND LUNO ASSIGNMENTS 

Figure 7-1 shows the relationship of the files accessed by TXLINK. Control information and file 
access names are passed by the Terminal Executive Development System (TXDS) via system 
COMMON. 

TXLINK supports up to three object input files and two output files. Each input file can contain 
^^- any number of concatenated object modules. Input LUNOs used are 10,6 , H ,5 and 1 2,6 . The out- 

put of TXLINK consists of a linked object file and load map listing. Output LUNOs used are 7 for 
the object file and 6 for the load map listing. 
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7.3 TXLINK EXECUTION 

TXLINK can only be executed under TXDS Control Program. The INPUT: parameter contains the 
pathnames of one to three input files. Each pathname must be separated by a comma. An input file 
may contain several object modules concatenated together. There may only be one end-of-file on 
each file, and the file must be a sequential file or device. All input files are rewound by TXLINK 
before they are used. 



^ 








^ 



LOAD MAP 
UlSTING 



''^^ 



Figure 7-1. Files Accessed by TXLINK 

The OUTPUT, parameter may contain two pathnames separated by a comma. The first pathname 
indicates the file to which the linked object code is written. The second pathname indicates the file 
to which the load map is listed. If either of the output files does not exist, TXLINK creates a 
sequential file with the pathnames entered. If the second output pathname is null, the system de- 
fault prmter is used. If only part of the pathname is defaulted, table 7-1 applies. 

Uteref^"^*^ ^°' ^^^ ^"^"^ '^"^ °"*''"* pathnames are listed in table 7-1. Finally, the options are 



/^^^ 



Table 7-1. Pathname Defaults 



Field 



Input 



Output 



Listing 



DEV 
FILE 
EXT 



DEFAULT DISC NAME DEFAULT DISC NAME 
NONE ^|ONE 

^^^ OBJ 



DEFAULT DISC NAME 

OUTPUT FILE 

LST 



..(T^^Stv 
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M^W*\ 






y^^N 



7.4 TXLINK CONTROL OPTIONS 

The following options control linking operations. All options are specified by a single alphabetic 
character followed in some cases by an override field. Input is free-form in that delimiters for 
options may be commas, blanks or no delimiters. The options are listed in table 7-2 and described 
in the following paragraphs. 

7.4.1 MEMORY OVERRIDE (M). This option allows a larger block of memory for tables to be 
allocated to the Linker Utility. The default memory size is 11,800 bytes. The syntax for the | 
option is: 

Mnnnnn 

Where n is a decimal number of the number of bytes required. There may be up to five decimal 
digits. The scan terminates when a nonnumeric character is encountered. 

The following are examples of the memory option: 

M4096 

M00300 

M24000 

7.4.2 COMPRESSED OBJECT (C). The use of this object enables TXLINK to write compressed 
object code to the linked object file. TXLINK writes standard object code unless the C option | 
is used. The syntax of the option is: ■ 



Compressed object format takes up less room on the diskette than standard 990 object code. The 
diskette is the only Floppy System device capable of supporting compressed object. The reader 
should be familiar with the Model 990 Computer object code format. If not, read the Model 990 
Computer IMS 9900 Microprocessor Assembly Language Programmer's Guide, or refer to 
Appendix B. 

Table 7-2. TXLINK Options 
Option Description 

Mnnnnn Override default memory size, default is 1 1800 bytes. 

C Compressed object output, 

laaaaaaaa IDT for linked object. 

P Partial link desired. 

L Print load map and symbol list. 

Note: n is a decimal digit and a is an alphanumeric character. 
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7.4.3 PROGRAM IDENTIFIER, IDT, OPTION (I). This option enables the user to specify an 

object identifier for the Hnked object. Otherwise, the IDT of the first module input will be used. -"^»*\ 

(An IDT is generated during assembly. It is the identification name of the module, and it is invoked ' 

by the "IDT" assembler directive.) The syntax of the option is: 

laaaaaaaa 

Where a is an alphanumeric character. 

The scan terminates on a delimiter, blank or comma, or after eight characters. 

Following are examples of the IDT option: 

IMYLINK 

IBADLINK 

IWOW. 

7.4.4 PARTIAL OPTION (P). The use of this option specifies that the module is to be partially 

linked. The partially linked module includes information for linking all unresolved references re- "^ 

maining in the module after the link. The partially linked object may be used in a subsequent 
Unking operation to finish resolving the references. The syntax of the option is: 



7.4.5 LOAD MAP OPTION (L). This option specifies that a load map listing is to be produced as 
shown in the example in figure 7-2. The two-line header of the load map listing identifies the 
version of TXLINK and shows the time and date of the run, provided the time and date have been 
initialized. The second line consists of the program name and its length. 



/"^^^SV 
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/^^^. 



TXLir-JK 937537 


:+:+ 12 : 07 ; 47 


0i: 


i:.-'77 PRQE 0001 






TKLINK 


LENGTH 1308 














MODULE 


LENGTH i; 


riRIGIN 


DRTE 


TIME 








TXLr-JKD 


03C2 


0000 


01. 


••12.-'77 


18 : 03 








TKLNKi 


041E 


03C2 


01. 


••12.--77 


18 : 06 








t:klnk2 


03RC 


07E0 


01. 


-•'12.-'77 


18 : 09 








THLNK3 


0466 


0B8C 


01. 


••••12.-'77 


18:12 








t:klnk4 


0316 

D 


0FF2 
E F I 


01. 

N I 


■•••13.-'77 

T I N S 


13 ; 10 






R0 


032E 


nSGFLQ 


02Ei:: 




RSQIN 


03BE 


RSGLUN 


02DF 


fiSGPRB 


ei2DC 


RSGPTR 


02F2 




RSSERR 


1262 


R RTOCRT 


0200 


BflDTflQ 


0225 


BINDEC 


0D52 




BINHEX 


0D28 


B I NONE 


032B 


BLfir-4K 


00DB 


CBDR 


0312 




i::BDR4 


0316 


CBDflS 


0317 


CBDflS 


0318 


CBHR 


031R 




CBHfl2 


031C 


CDRLIM 


0B98 


CDDLIM 


0B9R 


CHRB 


0300 




CHRBl 


030D 


CHflB2 


030E 


CLOSE 


02flC: 


CLROBJ 


0C9E 




CLSLUN 


02flF 


CLSOPC 


02flE 


CMPDLfl 


0320 


CMPDLD 


0322 




COMMR 


032F 


COMMON 


038E 


COriPRS 


03B4 


CRLF 


00FC 




DATE 


0026 


DflV 


00E8 


R DEV 


0000 


DEVSET 


1154 




DTLIST 


034C 


EF 


032D 


EMSQl 


0228 


EMSQ2 


024E 




EMSG3 


027R 


ENTRV 


03C2 


EOL 


00FD 


EPOINT 


03R8 




EPTRG 


03flfl 


fl EXT 


000D 


R FILE 


0005 


FLRQS 


07E6 




GETCMl 


0303 


GETCOM 


0302 


QETDflT 


0308 


GETHEX 


0790 




QETMEM 


0304 


QETSVL 


080E 


GETTflG 


0764 


HERDl 


00C6 




HERD2 


00FE 


HEDLEN 


0115 


HOUR 


00DC 


IDTEND 


0398 




IDTLEN 


0328 


IDTSflV 


00FE 


IDTTBL 


0396 


ILLCMN 


0186 




ILLHEX 


01flfl 


ILLNEM 


0198 


ILLPTH 


01DC 


ILLPUN 


0202 




ILLRED 


01F2 


ILLSUM 


01CE 


ILLTflQ 


0212 


ILLWRT 


0202 




INCMPR 


03C0 


INDFT 


0356 


INLUH 


0330 


INLUNl 


0331 




INPNM 


0026 


INPNMl 


0027 


INPTRS 


0388 


I0BF82 


0076 




lOBUF 


0026 


lOREQ 


0FF2 


LRSTIN 


0332 


fl LIBFLG 


158D 




LIMCHK 


07D0 


LNCNT 


0392 


LODRDD 


03B2 


LODPNT 


0398 




LOQERR 


0E2E 


LOG ID 


00C8 


LSTLUH 


033C 


MEMDFT 


034R 




MLEN 


0394 


MODCNT 


03BC 


MODLEN 


03fl0 


MULMOD 


0BS0 




R NRMESZ 


0010 


NEWSVM 


03 RC 


OBJEOF 


02D4 


OBJ IN 


02D0 




OBJLUN 


02D3 


OBJPTR 


0B94 


0BJR55 


00RD 


OBJR60 


00B2 




OBJR80 


00C6 


OBJRCl 


0077 


OBJRCD 


0076 


N ONE 


032fl 




OPEN 


02R0 


OPNLUN 


02ft3 


fl OPTCNT 


0006 


R OPTION 


0070 




OPTTBL 


0344 


OUTLUN 


0334 


N 0UTf-4M 


003R 


OUTNNl 


003 B 




N OUTOBJ 


0BB0 


PRGCNT 


0390 


PRGENO 


00FS 


PRRTRL 


03BR 




PRSS 


039E 


PRSS2 


04BC 


PGHDR 


1012 


PNTLOG 


104C 




PONTRS 


093R 


PRGLEN 


03R2 


N PRGNEM 


0CCE 


PRINT 


1042 




PROOPT 


10SE 


PUNCH 


02B8 


PUTCOD 


0D64 


PUTHEM 


0306 




RERD 


0DR2 


RECORD 


0026 


REFDEF 


0874 


RELRBS 


03R6 




RELES 


0323 


RELMEM 


03R4 


REWIND 


02C4 


REWLUN 


82C7 




R SDFTPR 


0eR4 


SEQBIN 


03 B6 


SEQDEC 


00C2 


SHERDl 


01iC 




SHEflD2 


0150 


SRCSVM 


a832 


SVRL 


07Ei:: 


SVN 


03 2C 




SVMBOL 


07E2 


SVMDI-1P 


yyL'b 


SVMEND 


039C 


SVMLST 


03BS 




SVMOVR 


01BC 


SVMTRB 


039R 


TBLEN 


0926 


TERM 


0308 




N TKLINK 


0000 


R TVPE 


0004 


UCPDLR 


0324 


UCPDLD 


0326 




VRLPTR 


07E8 


HP 


0006 


WPl 


0007 


WRTOP 


02BR 


















Figure 7-2. 


Load Map Listing 
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The heading is followed by a list of the modules, with the name (IDT) of each object module in 
the linked module, the length of each module, the origin of the module within the linked module 
and the date and time that each object module was generated. ^1 

The next section of the Hsting lists in alphabetical order the definitions in the modules. The symbols 
and corresponding hexadecimal values are printed four per line. The value is the definition within 
the linked module. When the listing shows an "N" preceding definition, the symbol was not 
referenced from another module. * 

When an "A" precedes a symbol, the symbol is self-defining (absolute). When the value is followed 
by a "U", the symbol is unresolved. When the value is followed by an "M", the symbol has been 
multiply defined, the first definition is the one that is used. 

After all definitions have been listed and if there are multiply-defined modules, IDTs, or symbols 
or if there are unresolved symbols, a corresponding message is printed as presented in the examples 
in the next paragraph. 

The load map is a useful tool during debug of an object module. After a task is loaded into memory, 

it has an absolute task origin, which is the absolute memory address of the task. If the user has the "^ 

Operator Communication (OCP) Software Module in his system, he can calculate the task origin by 

using the (STATUS) command. By adding the absolute task origin to any of the values in the 

load map, the user can get the absolute memory address of that symbol. 

The absolute memory address of a symbol that was not defined using a DEF directive within a 
module can be computed. First, add the relative address in the assembly listing (see Section IV, 
TX990 Assembler (TXMIRA)) to the relative origin value of the module's IDT found in the symbol 
map. Then add this sum to the absolute task origin in memory. The final sum is the absolute 
memory address of the symbol. 



7.5 LINKED OBJECT MODULE 

The linked object module produced by TXLINK consists of object code similar to that produced by 
the assemblers. Object code is described in the Model 990 Computer TMS9900 Microprocessor 
Assembly Language Programmer's Guide. As shown below, each module is terminated by a record 
beginning with a colon and containing the module name, date, time of linking and TXLINK 
identifier. 

: MODULE 004/77 13:29:39 TXLINK 

A fully-liftked object module is ready to be loaded and executed by the operating system. 

7.6 ERROR MESSAGES 

Table 7-3 Hsts fatal error messages that are printed on the LOG when TXLINK encounters an error. 



■""^^k 



^ 



/-^^^V 
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Message 
CANT GET COMMON 
CANT GET MEMORY 
ILLEGAL HEX DATA 
MEMORY OVERFLOW 
BAD CHECKSUM 



Table 7-3. Error Messages 
Description 
System COMMON not in system 
Memory requested is too large 
Nonhex digit found in input object 
Tables exceeded available area 
Bad input object code 



nn-ILLEGAL PATHNAME Pathname syntax error 



nn-READ ERROR 

nn-WRITE ERROR 

ILLEGAL OBJECT 
TAG-A 

nn-ASSIGN ERROR 
nn-CLOSE ERROR 



Error in reading object input 

Error in writing linked object or load map 

Module contains absolute load or entry 
address or garbage. "A" is tag that was 
found. 

Error in assigning or opening file 
Error in closing a file 



Recovery 

Regen system with COMMON 
Decrease size and retry 
Reassemble module 
Increase size and retry 
Reassemble module 
Correct and retry 
Check file and retry 
Retry 
Reassemble module 

Correct pathname and retry 
Correct pathname and retry 



Note: The error code nn is returned from the system. See Error Appendix D for meaning. 

7.7 TXLINK EXAMPLE 

The following three object modules will be linked to form one object module by using TXLINK: 



1 . This is the contents of the object file entitled :TXTSTl/OBJ 

00052TXTST1 A00OOCOO06C0045BOO0OA0026B16O0B0DOAB0A2OB4F4CB44207F215F 
A0030B4D45B5353B4147B4520B2D2DB2057B524FB4E47B2021B210DB0A007F2B7F 
A0046B0420B0000C0028B001DB2FE0C00267F856F 
40000CNT 40000NEW 30048WRITE 7F8A8F 

^ TXTSTl 054/77 08:49:34 TXMIRA 



0001 
0002 
0003 
0004 
0005 



2. This is the contents of the object file entitled :TXTST2/OBJ 

0001DTXTST2 A0000B0D0AB0A48B4 1 56B4520B4120B474FB4F44B2044B4 1 597F1 DOF 
B202 1 B2 1 20B2020B2020B200DB0A007F984F 
6001DCNT 50000NEW 7FB3AF 

TXTST2 054/77 11:18:34 TXMIRA 

3. This is the contents of the object file entitled :TXTST3/OBJ 

00030TXTST3 A0000C0006C0026B0000B0000B0B00B0000B0000B0000B00007F287F 

A0012A0026BC0FEBC17EB2FE0C0006B03807F805F 

50000WRITE 7FD29F 

TXTST3 054/77 11:11:36 TXMIRA 



0001 
0002 
0003 
0004 



0001 
0002 
0003 
0004 
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The following example loads and executes TXLINK using the above three files as input parameters. 
The resultant file, :TXTST/OBJ, holds the linked object module. 



^ 



PROGRAM: 


:TXLINK/SYS 


INPUT: 


:TXTSTl/OBJ,:TXTST2/OBJ,:TXTST3/OBJ 


OUTPUT: 


:TXTST/OBJ 


OPTIONS: 


ITXTST>1400,L 


TXLINK 


937537** 



Following is the link map, which is generated when an "L" is entered in the OPTION: parameter 
line: 



TXLINK 937537 ** 08:57:21 054/77 
TXTST LENGTH OOAO 



MODULE 

TXTST 1 
TXTST2 
TXTST3 



LENGTH ORIGIN DATE 



0052 
OOIE 
0030 



0000 
0052 
0070 



054/77 
054/77 
054/77 



PAGE 0001 



TIME 

08:49 
11:18 
11:11 



^ 



DEFINITIONS 

N CNT 00 ID N NEW 0052 WRITE 



0070 



Following is the contents of the object file entitled :TXTST/OBJ. This file may be loaded into 
memory and executed. 



OOOAOTXTST A0000C0006C0045B0000 A0026B 1 600B0D0AB0 A20B4F4CB44207F2 1 CF 
A0030B4D45B5353D4147B4520B2D2DB2057B524FB4E47B2021B210DBOA007F2B7F 
A0046B0420C0070C0028B00 1 DB2FE0C0026B0D0AB0A48B4 1 56B4520B4 1 207 F2E0F 
A005CB474FB4F44B2044B4 1 59B202 1 B2 1 20B2020B2020B2O0DBOA0OC00767F2EFF 
A0072C0096B0000B0000B0B00B0000B0000B0000B0000A0096BC0FEBC17E7F30BF 
A009AB2FE0C0076B03807FB62F 

TXTST 054/77 08:57:21 TXLINK 



0001 
0002 
0003 
0004 
0005 
0006 
0007 



^ 



z"^^. 



^ 
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SECTION VIII 
TXDS COPY/CONCATENATE (TXCCAT) UTILITY PROGRAM 

8.1 INTRODUCTION 

The TXCCAT program copies one to three files to a single output file. Although simple record 
modifications are supported upon output, the program is basically a file copy by which sequential 
and relative record files may be duplicated or concatenated together into one file with no embedded 
end-of-files. TXCCAT copies information from cassettes, files or card reader input to cassettes, 
files, or printing devices. 

NOTE 

TXCCAT does not insert carriage control characters into its output 
f^ file; therefore, it will not correctly copy nonlisting type files to a 

listing device, such as a printer. 

TXCCAT is a software module which runs under the Terminal Executive Development System 
(TXDS). 

8.2 TXCCAT LUNOs 

The TXCCAT program uses LUNOs 7, 10, 11 and 12. LUNOs 10, 11 and 12 are assigned to the 
input files; LUNO 7 is assigned to the output file. All LUNOs are released upon termination of 
TXCCAT. 



8.3 OPERATOR INTERACTION 

TXCCAT is executed via the TXDS control program. Input and output pathnames are passed via 

COMMON. Table 8-1 provides the pathname defaults. 



The INPUT: parameters may have one to three pathnames separated by commas. The files v/ill 
be used to generate an output file. The OUTPUT: parameter contains one pathname to be used 
for the output file. Input files must preexist and can be either sequential or relative record. Output 
files are assumed to have the same characteristics as input files, although input records may be 
^ modified for output. If input is from a device, the output file is sequential and, if the output file 

does not exist, it is created. If no output file is specified, the default-system print device is used. 
The default-system print device is defined during system generation. 





Table 8-1. Pathname Defaults 




Field 


Input 


Output 


DEV 


System Disc 


System Disc 


FILE 


None 


First Input File Name 


EXT 


SRC 


First Input Extension 
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8.4 OPTIONS 

All TXCCAT options are specified by two alphabetic characters followed, in some cases, by a -'^ 

decimal numeric field. Input format is free-form. Delimiters for options may be commas, blanks 

or no delimiter. Each time a new pair of characters is read it is considered a new parameter. An 

illegal parameter results in an error message and program termination. Table 8-2 lists the options 

recognized by TXCCAT. 

The numeric scan terminates after the maximum size is exhausted or a nonnumeric character is 
encountered. 

8.4.1 TRUNCATE OPTION (TR). The truncate option truncates records to the size specified. The 
syntax is as follows: 

TRnnnn 

where n is a decimal number and four digits is the maximum field size. The following are examples: 



TRnnnn Truncate record to length nnnn. 

FLnnnn Fix records to size nnnn by padding with blanks or by truncation. 

SKnnnn Skip nnnn input records, prior to output. 

LFnn List file, page length = nn, default = 55. 

SLnn Space lines on listing, nn = space count, default = 0. 

NL Number lines on listing. 

RI Do not rewind input on open. 

RO Do not rewind output on open. 

Note: n is a decimal digit and the maximum field size is given by the number of n's. 



^, 



TR76 Truncate to 76 characters. 

TR0076 Truncate to 76 characters. 

8.4.2 FIX RECORDS (FL). This option forces input records to a specified size by either padding 
with blanks or by truncation. The syntax is as follows: 

FLnnnn 

where n is a decimal number and four digits is the maximum field size. The following are examples: 

FL76 Fix to 76 characters. ^ 

FL0076 Fix to 76 characters. 

Table 8-2. TXCCAT Options 
Option Description 



'^^ 



yr^?^^ 
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8.4.3 SKIP RECORDS (SK). This option skips the specified number of input records prior 
/•^ to output. The syntax is as follows: 

SKnnnn 

where n is a decimal number and four digits is the maximum field size. The following are examples: 

SK200 

SK0020 

SK9999 

8.4.4 LIST FILE (LF). This option lists files and allows the use of the NL and SL option. The 
numeric field gives the printer page length. If the page length is not specified, 55 hnes per page 
is the default. The syntax is as follows: 

LFnn 

where n is a decimal number and 2 digits is the maximum field size. The following are examples: 

LF 
LF55 
LF06 
LF99 

8.4.5 SPACE LISTING (SL). This option is only in effect with the list option LF. The numeric 
field gives the number of blank lines to print for each input line. The syntax is as follows: 



ipB\ 



^ SLnn 

where n is one or two decimal digits. The following are examples: 






/^^^\ 



SL 


No Spacing 


SLl 


Single Spacing 


SL2 


Double Spacing 



8.4.6 NUMBER LINES (NL). This Option is only in effect with the list option LF and causes 
the printing of the line numbers associated with the input lines. The syntax is as follows: 

^L 

8.4.7 NO INPUT REWIND (RI). When this option is selected, the input is not rewound when 
opened. The syntax is as follows: 

RI 

8.4.8 NO OUTPUT REWIND (RO). When this option is selected, the output is not rewound 
when opened. The syntax is as follows: 

RO 
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8.5 EXAMPLES 

The following three examples show how to use TXCCAT to: copy a file to a cassette; copy three 
files to another file; and list a file on a printer. Each example assumes that the TXDS Control 
Program is active and that a diskette containing TXCCAT is loaded. 



Example 1: 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



Example 2: 



PROGRAM 

INPUT 

OUTPUT 



:TXCC AT/SYS 
DSC2:TXTST1/0BJ 

CSl 
FL80 



:TXCCAT/SYS 

DSC:TXTST1/SRC,DSC2:TXTST1/SRC,CS1 

DSC2:TXTST3/SRC* 



Example 3: 

This example assumes that a line printer is included in the system. 



--^ 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXCCAT/SYS 
DSC2:TXTST3/SRC 
LP 
LF66,SL1,NL 



8.6 ERRORS 

The errors generated by TXCCAT are listed in table 8-3 together with possible corrective action. 



'"^^ 



Error 

CANT GET COMMON 

ILLEGAL OPTION - aa 

nn - ILLEGAL 
PATHNAME 

nn - READ ERROR 

nn - WRITE ERROR 

nn - OPEN ERROR 

nn - CLOSE ERROR 



Table 8-3. TXCCAT Errors 
Description 

System COMMON not in system 

Option aa not found 

Input files does not exist or 
open error 

Error in Reading File 

Error in Writing File 

Error in opening or assigning files 

Error in closing a file 



Action 

Regenerate system with COMMON 
Reenter correct option 
Correct and Retry 

Retry 
Retry 
Correct pathname and retry 

Correct pathname and retry 



/•^^ 



Note : nn is the system I/O status error given in Appendix D. 
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SECTION IX 
TXDS STANDALONE DEBUG MONITOR (TXDBUG) UTILITY PROGRAM 

9.1 INTRODUCTION 

This section discusses the capabilities and operation, of the TXDS standalone debug monitor, 
TXDBUG, explains how to debug under monitor control, gives detailed descriptions of the 
commands available to the user, and supplies debugging techniques. The following topics are 
covered : 

• TXBUG installation procedures for 733 ASR, 9 1 3 VDT or 9 1 1 VDT system consoles. 

• A general description of TXDBUG, including functions, features and capabilities. 

• A detailed description of the operating procedures necessary to load TXDBUG and the 
program to be debugged. 

• A description of two modes of debugging: one in which the program being debugged 
executes with minimal TXDBUG intervention, and one in which TXDBUG exercises tight 
control of the program being debugged. 

• A description of TXDBUG command structures, and the operator interface to TXDBUG. 
© Detailed descriptions of each of the debug commands. 

• A discussion of debugging techniques including general techniques and techniques specific 
to TX990. 

• A discussion of methods used to patch programs (i.e., to correct them in memory rather 
than at the source code level.) 

• A summary of errors which may occur during a debugging session. 

The TXDBUG provides for debugging programs which have been designed to operate in a "stand- 
r^ alone" environment with no operating system support. The debug monitor attempts to 

"hide" itself from the program being debugged, using as few machine resources as possible in the 
performance of debug tasks. 

The following minimum hardware system configuration is required to run the standalone debug 
monitor: 

• 990/4 CPU (including 6-slot chassis and Programmer Panel), or 990/ 1 CPU 

• When a 990/4 CPU is used, 4096 words dynamic RAM Memory Expansion including 
Memory Write Protect and Memory Parity are needed. 

• 733 ASR Data Terminal, 913 VDT or 91 1 VDT 

• FD Floppy Disc. 
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9.2 GENERAL DESCRIPTION 

The TXDBUG is memory-resident and communicates interactively with the operator through the -"^ 

733 ASR Data Terminal keyboard and printer. It provides the following capabilities: 

• Inspection and modification of memory, registers, and CRU space 

• Controlled execution of user programs with optional trace of instructions and/or data 

• Multiple breakpoints with optional automatic display of registers and specified memory 

• Miscellaneous aids such as hexadecimal arithmetic and search-under-mask. 

I 9.3 INSTALLATION OF TXDBUG 

To install TXDBUG, a file name :SADBUG/SYS must be created on the TXDS Utilities Diskette. 
Then, one of the three stand-alone debug monitors listed below must be copied into it. The three 
debug monitors are named: 

SADPRT/SYS 733 ASR, 743 KSR or 33 ASR (TTY) 

SAD911/SYS 911 VDT '^ 

SAD913/SYS 913 VDT 

Example: 

If the device to be used as the debug console is the 911 VDT, perform the following: 

1 . Place the TXDS System Diskette in DSC and TXDS Utilities Diskette in DSC2. 

2. Respond to the following prompts by entering: '"^ 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXCCAT/SYS 

DSC2:SAD911/SYS 

DSC2:SADBUG/SYS 



This will be create the file :SADBUG/SYS on DSC2 and copy :SAD911/SYS from DSC2 to the 
:SADBUG/SYS file. 

9.3A LOADING TXDBUG ^ 

The TXDBUG program is stored as a file on the TXDS Utilities Diskette. To load TXDBUG and 
begm the debug session, invoke the program load facility of TXDS and specify the following 
parameters: f j ne 



PROGRAM 

INPUT 

OUTPUT 

OPTIONS 



:TXDBUG/SYS 

<file name of program to be debugged> 

<hexadecimal integer specifying the load point of the program tobedebugged> 

The file name supplied for the input parameter must include all extensions. The loader will search 
all available drives if the device name is not specified. 

If the load point of the program to be debugged is not supplied, TXDBUG assumes the default value 
>A0. 



'^^h. 
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After TXDBUG has been successfully loaded, the TXDBUG load point, entry point, and length are 
printed: 

TXDBUG 937567 *A ■ 

TXDBUG LOAD POINT = ENTRY POINT = LENGTH = 



NOTE 

For certain debug operations the TXDBUG entry point is required. 
Make note of the entry point at this time. 

When the loading process is completed, the TXDBUG will prompt the operator with a period ("."). 
At this time the memory configuration (for a 16K system) will appear as illustrated in figure 9-1, 
with the user's program located as specified by the load point in the option parameter. TXDBUG 
may be used to debug any program for which the instruction and data space does not overlap 
TXDBUG. 

^ NOTE 

Since the user's program overlays the TX990 executive, the TX990 
executive must be rebooted when the debug session is finished. 

Once the user program is entirely debugged, it may become the executing program when a disc 
boot is performed by using the "SF" operation described in the TX990 Operating System Pro- 
grammer's Guide, 

^- In the following description of TXDBUG usuage, the ESCAPE key denotes the ESC key on a 91 1 

VDT or 733 ASR and the RESET key on a 913 VDT. 



p 



/^^^\ 
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BYTE 
ADDRESS 

0000 

007F 
0080 

009F 
OOAO 



FUNCTION 

INTERRUPT AND XOP VECTORS 
FRONT PANEL WORKSPACE 



^ USER SPACE (CONTAINS THE PROGRAMS 
P TO BE DEBUGGED) 



/!!fll\ 



7FFF 






DEBUG MONITOR (TXDBUG) 



F800 

F9FF 
FAOO 

FBFF 
FCOO 




> FRONT PANEL AND SELF-TEST 
DATA AREA 



> OPTIONAL RAM/ROM 



. FRONT PANEL S/W,ROM 
> LOADER, AND SELF-TEST 
ROMS 



990/4 
ONLY 



/^P™\ 



Figure 9-1 . Debug Monitor Memory Configuration 

9.4 DEBUG MODES 

The user may specify that the debug monitor execute the program being debugged in either of two 
different modes: Execute free, or Run controlled. When executing free, the monitor reUnquishes 
control to the test program which is then executed at full processor speed. This mode is only 
recommended when a program is expected to be error free or when timing considerations are being 
examined. The only way to interface with the monitor in this mode is to bracket instruction 
sequences in the test program with LREX instructions or with unconditional branches to the debug 
monitor entry point. An LREX has the same effect as pressing the HALT switch on the front panel. 
An unconditional branch to the monitor entry point restarts the monitor. If this is attempted and 
the monitor does not respond with a period prompt ("."), the probable cause is that the executing 
program has destroyed the monitor. 
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The normal method of execution during program debug is to initiaUze the PC, WP, ST by using the 
Modify AU Registers (MR) command and use the RUN (RU) command. In the RUN mode, the ^'"^x 

monitor uses the Single Instruction Execution (SIE) facility to execute the user's program one in- 
struction at a time. Execution continues until: the number of instructions specified have been 
executed; a breakpoint occurs; or the operator presses the ESCAPE key on the 733 ASR Data 
Terminal keyboard. The Execute (EX) command can be used in place of the RUN command. 
Using this command, the program is executed without using the SIE or trace features. 

The highest level of control is exercised when a test program is being executed via the RUN 
command and the instruction address is within a Trace region. In this case, each instruction is 
interpretively executed by the monitor. Source and destination operands are examined and op- 
tionally printed before and after each instruction. The amount of information printed as each 
instruction is executed is determined by user-defined Trace regions (SR command). 

NOTE 



Set and clear program elements, 



^ 



^ 



Trace regions are ignored when the EX command (Execute free) is 
used. 

9 .5 DEBUG MONITOR COMMAND STRUCTURES 

To interact with TXDBUG, the user enters commands at the 733 ASR Data Terminal. 

The available debug commands may be classified into the following groups. 

• Set commands. These commands allow the user to define up to four of each of the 
following aids: program-counter breakpoints, formatted snapshots, trace regions, and 
trace formats. 

• Clear commands. These commands allow the user to remove the effect of a previously set 
command. 

• Inspect commands. These commands allow the user to display the contents of AU 
registers, workspace registers, memory regions, and CRU lines. These commands are also 
used to force snapshots. 

• Modify commands. These commands allow the user to examine and optionally modify: 
memory; workspace registers; AU registers; and CRU lines (by inspecting the input and 
modifying the output). 

• Miscellaneous commands. These commands include functions such as word and byte 
memory searches, and hexadecimal arithmetic with automatic decimal conversion. 

When debugging a program, the user may specify that TXDBUG: 

• Print data on the terminal for examination, 

• Modify data, 

• Specify program elements (parameters whose values are determined by the user) for 
interpreting the progress of his program, 



^ 
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• Search for specific bit patterns in bytes and words, 

• Perform arithmetic calculations with hexadecimal numbers. 

These actions may be performed on memory, registers, and CRU input and output lines. They may 
also be performed on specifiable debug elements: breakpoints, snapshots, and trace regions. The 
^ debug elements are defined as follows: 

• Breakpoint - A point during the execution of a program at which control is returned to 
TXDBUG to allow the user to examine the progress of his program or enter any of the 
debug commands. 

• Snapshot - A printed display of the contents of contiguous workspace registers plus the 
contents of an area in memory as defined by the operator. A snapshot may be printed 
automatically at a breakpoint. 

• Trace region - An area of the program about which information concerning the 
^ execution of an instruction is output on the printer. This information may be printed 

following the execution of each instruction, each branch, or each change in the contents 
of a data word. 

9.5.1 DEBUG COMMAND CODES. All debug commands are comprised of a two-letter mnemonic, 
the first of which denotes the operation to be performed (inspect, modify, etc.). The second identi- 
fies the debug or machine element upon which the operation is to be performed (memory, CRU, 
etc.). The four general-purpose operations are as follows: 

I — Inspect 

M - Modify 

S - Set 

C - Clear. 

The elements on which these operations may be performed are: 

rM — Memory 

W - Workspace registers (RO -Rl 5) 
R - AU Registers (WP, PC, ST) when used with I, or M. 
R - Trace Region when used with S or C 
C - CRU 
B — Breakpoint 
S — Snapshot 
T — Trace Type 
r P - Protect region (invalid for computer without write-protect option). 



^"^ Digital Systems Division 




946258-9701 



^ 



Some combinations of operations and elements are illegal. Table 9-1 identifies the valid 
combinations. Table 9-2 lists the available two-letter mnemonics associated with the valid 
combinations. 

9.5.2 MISCELLANEOUS COMMANDS. The following are classified as miscellaneous commands: 
EX — Execute a user program. 

RU — Run a user program. 

HA - Hexadecimal arithmetic. 

FB — Search under mask for a particular 8-bit pattern (Find Byte). 

FW — Search under mask for a particular 16-bit pattern (Find Word). 

9.5.3 COMMAND ENTRY. Readiness of the monitor to accept a command is indicated when the 
monitor "prompts" the operator by printing a period (".") as the first character of a new line. For 
all activities except when a user program is being executed free (EX command) the operator may 
force a return to the command mode by pressing the ESCAPE key on the 911 VDT or 733 ASR 
terminal, or RESET on the 9 1 3 VDT. "^ 

From zero to eight parameters may be entered with each two-letter command. The command is 
separated from its parameter Hst by a comma (",") or by one or more blanks. Each parameter in 
the hst is terminated by a comma or by one or more blanks, with the parameter Hst being ter- 
minated by a carriage return. As each parameter is entered, its syntax is vaUdated by the monitor. 
The parameter may either be a hexadecimal number, a binary number, or a character string. The 
backspace character (CTRL-H on the 91 1 VDT or 733 ASR terminal, or ^ on the 913 VDT) may 
be used to change the entered characters, or the entire parameter may be reentered by pressing 
the delete key (RUB OUT on the 733 ASR terminal). The entire command entry may be aborted ^^ 

by pressing the ESCAPE key on 91 1 VDT or 733 ASR terminal (RESET on 913 VDT). ) 

If an error is detected by the monitor during command entry, one of the following error codes will 
be printed: 

Code Meaning 

MPOO Invalid parameter or hexadecimal number entered, or maximum parameter list 

exceeded. 

MSOl Invalid command. The first two characters do not match any known command. 

A complete list of error codes appears in paragraph 9.8. 

Table 9-1 . Valid Debug Command Combinations 

Element 

Operation MWRCBSTP 

I X X X X X 

M X X X X 

S X X X X X 

C X X X X 

("X" indicates acceptable combination.) 
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Table 9-2. TXDBUG Keyboard Commands 



IC 


Inspect Control Register Unit (CRU) 


IM 


Inspect Memory 


IR 


Inspect AU Register (WP, PC, ST) 


IS 


Inspect Snapshot 


IW 


Inspect Workspace Registers 


MC 


Modify Control Register Unit (CRU) 


MM 


Modify Memory 


MR 


Modify Registers 


MW 


Modify Workspace Registers 


SB 


Set Breakpoint 


SP 


Set H/W Write Protect Option 


SR 


Set Trace Region 


SS 


Set Snapshot 


ST 


Set Trace 


CB 


Clear Breakpoint 


CP 


Clear H/W Write Protect Option 


CR 


Clear Trace Region 


CS 


Clear Snapshot 



9.5.4 NOTATIONAL CONVENTIONS. The notational conventions used in the syntax definitions 
of the keyboard commands are as follows: 

< > Item to be supplied by the user. The term shown within angle brackets is a generic 
term. 

[ ] Optional item ~ may be included or left out, at the user's discretion. Items not 

enclosed in brackets are required. 

] \ Choice to be made from two or more items, one of which must be included. 

Items in capital letters in the syntax definition are entered into the command statement exactly 
as shown. 

The fields in the command (the command mnemonic and the parameters) are separated by either 
commas or strings of one or more blanks. This choice is shown sumbolically as: 



{;...} 



When one or more parameters are omitted, two or more field separators may occur in sequence. The 
user must be sure that he includes the correct number of separators in a sequence; he should be 
aware of how they are interpreted by the computer. Two strings of blanks run together will be 
read as a single long string of blanks. A comma preceded or followed by a blank will be read as two 
separators in sequence. It is suggested, therefore, that commas (without preceding or following 
blanks) be used to set off omitted parameters. 
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In the examples of command statements, user-supplied data is underlined to distinguish it from data 

printed by the monitor. The carriage returns that terminate command statements are not shown in ^^*\ 

the examples. 

9.6 COMMAND DESCRIPTIONS 

Each command supported by the debug monitor and a brief functional description is presented in 
table 9-2. Detailed descriptions of the "miscellaneous" commands are presented in paragraphs 9.6.1 
to 9.6.5. The remaining paragraphs provide detailed descriptions of the "debug" commands. 

9,6.1 EXECUTE USER PROGRAM (EX). The Execute User Program command is used to execute 

a user program at speed with neither interference from nor control by the monitor. The program is * 

executed at full processor speed. Initialize the AU registers (ST, PC, WP) using the MR command 

before using the EX command. 

Syntax definition: 

.EX 

Description: The program is executed directly by the 990 computer without using the SIE or trace ^ 

features. Execution is started with the PC, WP and ST that would be displayed if an Inspect 
Registers (IR) command were executed. 

Application notes: In order to regain control from an executing user program, the user must 
transfer control to the monitor's starting memory location. This may be done by inserting a branch 
in the test program or by using the programmer panel. 

Upon regaining control in the monitor, the WP, PC, and ST registers will have the same values as 

before the EX command unless execution of the user program destroyed the monitor data space. ^'^ 

Example: 

Assume the user has written an assembler which assembles source from cassette or terminates 
depending on user input. 

-IB 

PC=046C WP=0000 ST=0000 

.EX 

ASM/TERM? A ^ 

ASM/TERM? T 

•IE 

PC=046C WP=0000 ST=0000 

The EX command begins execution with the PC, WP, and ST registers equal to the values obtained 
when the Inspect Registers (IR) command is invoked. A program run under EX does not change the 
contents of these registers. The second IR command shows that the contents remain the same. ^ 



x^a^ 
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9.6.2 EXECUTE USER PROGRAM UNDER SIE OR TRACE (RU). The Execute User Program 
under SIE or Trace command provides controlled execution of the user's program. InitiaUze the 
AU registers (ST, PC, WP) using the MR command before using the RU command. 



Syntax definition: 

RU jw 1 <anstruction count>| 



jw I <3nstruction count>| 



i^ippi\ 
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Parameter: 

( instruction count Maximum number of instructions to be executed 

before returning to command mode. A value of 
indicates an infinite instruction limit applies. 

^ Parameter default value: The value of the instruction count at the last entry into command mode 

is used as the default value. If the previous RU command has exhausted the instruction count, the 
default is 0, implying no instruction limit. The system is initially loaded with a default value of 0. 

Description: Instructions in the user's program are executed one at a time using either the hardware 
SIE feature or the software trace interpreter. The user may specify one of these two modes of 
operation with the Set Trace Region (SR) command (paragraph 9.6.12). The user is referred to 
The 990 Computer Family System's Handbook, part number 945250-9701, for a detailed explana- 
tion of SIE. 

Before the monitor executes a user instruction, it checks whether the instruction is within a defined 
trace region. If the instruction is within a trace region, the trace interpreter is called and the in- 
^ struction traced. If the instruction is not within a trace region, the instruction is executed using 

Single Instruction Execution. In both cases, the user's WP, PC, and ST registers are updated after 
each instruction executed. The monitor checks whether a breakpoint has been reached and if so, 
prints out the user's registers and snapshot, if defined. If a snapshot is assigned to a breakpoint, the 
monitor continues execution after the breakpoint has been reached, without operation intervention. 
If no snapshot was specified, the monitor returns control to the command processor. (Refer to the 
descriptions of the SB and SS commands in paragraph 9.6.6.1 and 9.6.11.1.) If the run count, 
number of instructions to be executed, is depleted, the monitor returns control to the command 
processor. Otherwise the monitor continues execution of the user program. 



r 



r" 



9.6.3 HEXADECIMAL ARITHMETIC (HA). The Hexadecimal Arithmetic command calculates 
the sum and difference of two hexadecimal numbers. The 2's complement hexadecimal value and 
the signed decimal value are printed. 



Syntax definition: 

"A [k..} H'^^^] [i..} <'^^'>]] 

^^ Parameters: 

value Hexadecimal number value (0-4 digits). 

Parameter default values: 

If the value parameter is not specified, a default value of is used. 

Application note: No overflow checks are made; therefore, two positive numbers may have a 
negative sum. All results are represented in 16 bits. 
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Examples: 

. HA 103 A BA2 ' 

SUM=1BDC 07132 DIFF=0498 +01176 

. HA 89 89 

SUM=0112 00274 DIFF-0000 +00000 

. HA 8030 EFOO 

SUM=6F30 28464 DIFF=9130 -28368 

. HA EFOO 

SUM=EFOO -04352 DIFF=EFOO -04352 

The calculated difference between the specified number values is the first value minus the second ^ 

value. 

9.6.4 FIND BYTE (FB). The Find Byte command is used to scan an area of memory for a 
particular byte value. 

Syntax definition: 

FB k I Kstart mem addr>J U } Kending mem addr>J {' | 
<desired value> |' | <mask> 



,y^m^ 



The command is terminated by a carriage return. 
Parameters: 

start mem addr Memory address at which search begins. 

(M character hexadecimal number.) ^ 

ending memory addr Memory address at which search is terminated. 

(1-4 character hexadecimal number.) 

desired value Hexadecimal value for which the search 

is made. This value is required. 

mask Hexadecimal value to be ANDed with each 

byte before comparing it with the desired 
value. 

Parameter default values: 

If the starting memory address is not specified, a value of is used. 

If the ending memory address is not specified, a value of FFFFi^ is used. 

If the mask parameter is not specified, a value of FTK, is used. 



^ 
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Description: Each byte in the memory search range is ANDed with the mask and compared to the 
desired value. The memory location and contents are printed out whenever a match is found. After 
each match, the user must enter a space on the terminal keyboard to continue the search. If he 
enters a carriage return, the command terminates. 



Error messages: 

DP 13 The ending address is less than the starting 
address. Reenter the command. 

MS05 The <desired value> parameter is missing. 
Reenter the command. 

MX06 The beginning address is an invaUd memory 
address. Reenter the command. 

Application notes: No check is made to ensure that the mask does not exclude a bit required by 
the desired value, thereby making a match impossible. If the monitor data area is being searched, 
r^ results may not appear to be correct since the monitor is changing during the search process. 

Examples: 

, FB 0,2000.0.0F 

0000=0000 

0000=0000 

0002=0000 

0002=0000 
^^. 0004=0000 

' 0004=0000 

0006=0000 

0006=0000 

0008=0000 

■FB 0.2000.06.0F 



0300=0456 
0644=0556 



In the fiist example, the high order four bits of each byte are masked so that any byte with a 
in the low order four bits will be located. The address of the leftmost byte of each word is 
printed so that if both bytes of a word are printed, an address location will be printed twice. 
For example, if bytes 0004 and 0005 are printed, the address 0004 will appear twice in the 
listing. 

In the second example, the high order four bits of each byte are masked so that any byte with a 
6 in the low order four bits will be located. 

9.6.5 FIND WORD (FW). The Find Word command is used to scan an area of memory for a 
particular word value. 



9-1 1 Digital Systems Division 




946258-9701 



Syntax definition: 

FW t I [<start mem addr> 



<desired value> 



J ih I K®"^^^8 inem addr> j' | 



^ 



The command is terminated by a carriage return. 
Parameters: 



start mem addr 



ending memory 
addr 

desired value 



mask 



Memory address at which search begins. 
(1-4 hexadecimal characters.) Must be 
even byte (word) address. 

Memory address at which search is terminated. 
(1-4 hexadecimal characters.) 

Hexadecimal value for which the search 
is made. The value is required. 

Hexadecimal value to be ANDed with each word 
before comparing it with desired value. 



^ 



Parameter default values: 

If the starting memory address is not specified, a value of is used. 

If the ending memory address is not specified, a value of FFFFjg is used. 

If the mask parameter is not specified, a value of FFFFie is used. 

Description: Each word in the memory search range is ANDed with the mask and compared to 
the desired value. The memory location and contents are printed out whenever a match is found. 
After each match, the user must enter a space on the terminal keyboard to continue the search. 
If he enters a carriage return, the command terminates. 

Error messages: 

DPI 3 The ending address is less than the starting 
address. Reenter the command. 

MPOO The beginning address is an invalid memory 
address. Reenter the command. 

MS05 The <desired value> parameter is missing. 
Reenter the command. 



^ 



"^ 
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Application notes: No check is made to ensure that the mask does not exclude a bit required by 
the desired value, thereby making a match impossible. If the monitor is being searched, results 
may not appear to be correct since the monitor is changing during the search process. 



Examples: 



. FW 0,2999,456, 

0300=0456 

. FW 0,2000,56,OOFF 

0300=0456 

0644=0556 



In the second example, the monitor searches for words with a 56 in the low order byte. By 
pressing the space bar on the terminal keyboard, the user can cause the monitor to continue 
searching for another occurrence of the data word. 



9.6.6 BREAKPOINT COMMANDS (SB, CB). 

indicated in the following paragraphs. 



These two commands control breakpoint as 



9.6.6.1 Set Breakpoint (SB). The Set Breakpoint command is used to define a breakpoint which 
causes the processor to stop or interrupt execution of a user program prior to executing the in- 
struction at the specified memory address. 

Syntax definition: 

SB g j <bkpt no.> {^ j <memory addr> [{^ } r<ref cnt>J 
N^ J <snapshot no.> 



i^^S 



Parameters: 



bkpt no. 



memory 
addr 



ref cnt 



snapshot no. 



j^^\ 



Breakpoint index number. The number may be 0, 
1 , 2 or 3. Required parameter which services as a 
unique identifier for individual breakpoints. 

Address of an instruction on which the breakpoint 
is to be set. Required parameter. (1-4 hexadecimal 
characters.) 

The pass number (hexadecimal) on which a break- 
point is to be taken. For example, a reference 
count of 3 means to break on the third reference 
to the memory address for an instruction fetch. 
Default value is 1 . 

Index number of a previously defined snapshot 
which is to be displayed when the breakpoint 
is taken (see SS command). Default value is no 
snapshot 0, 1, 2, 3. 
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Parameter default values: 

If the reference count (pass number) is not specified, a value of 1 is used. If the user enters a ) 

value of 0, it is equivalent to a reference count of FFFF,6. 

If the snapshot number is not specified, a snapshot is not printed. 

Use of breakpoints: The breakpoint is one of the key elements in program debugging because it 
enables the user to specify conditions under which he wants to receive control. Breakpoints are 
particularly useful when the user wants to intercept control after an unexpected control transfer 
occurs from a conditional branch. By setting a breakpoint on the unexpected or error path out 
of a conditional branch, the program may be allowed to execute without interruption unless 
some error condition occurs. 

When a breakpoint is encountered, the contents of the processor registers are displayed. (The 

contents are the values that would be displayed if an IR command were to be invoked.) The 

breakpoint index number is aiso displayed to aid in determining which breakpoint was 
encountered. 



Error message: 



^ 



DP20 Breakpoint specification error. Required index number may 
be valid or missing, or the PC value (memory address) may 
have been omitted. 

Application notes: The PC value for a breakpoint must point to the first word of a multiword 

instruction. 

^^ 
A breakpoint occurs before the execution of the instruction to which it pomts. ) 

If a snapshot is associated with a breakpoint, execution of the user program resumes after the 
snapshot is printed. If no snapshot is associated with the breakpoint, execution terminates and the 
debugger accepts another command. 

If more than one breakpoint is associated with a specific loation, only the first (lowest numbered) 
will be found. 

When execution is under the control of the Execute User Program under SIE or Trace (RU) com- ^ 

mand with an instruction count: (1) a breakpoint occurs; and (2) a new count is not specified 
on the next RU command. Then, when execution is resumed, counting is continued as if no break- 
point was encountered. 

Breakpoints are not active when the user code is executed with the EX command. 

An error is not reported when a Set Breakpoint (SB) command redefines an already defined break- 
point. The specified breakpoint is modified to take on a new definition. This feature may be used 
to modify the snapshot index associated with a breakpoint. 



/^«^ 
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Examples: 
( . SB 0.1000.1.2 

. SB 1.1000.1.0 
. SB 2.1004 

The first two examples set a breakpoint at address 1000 on the first reference to that address for 
an instruction fetch. The first example sets breakpoint index number with snapshot index 
number 2 to be displayed, and the second example sets breakpoint index number 1 with 
snapshot index number to be displayed. The third example specifies breakpoint index number 
2 to be taken at memory location 1004,6. No snapshot is printed, and execution of the user 
program terminates after the breakpoint is encountered. 

9.6.6.2 CLEAR BREAKPOBST (CB). The Clear Breakpoint command is used to disable 
previously specified breakpoints. 

\ Syntax definition: 

CB 11 ' I <starting breakpoint number> jj' | <ending breakpoint number> 

The command is terminated by a carriage return. 
Parameters: 

starting breakpoint The first breakpoint to be cleared. A 
number number from to 3. 

ending breakpoint The last breakpoint to be cleared. A 
number number from to 3. 

Parameter default values: 

If no parameters are specified, all breakpoints are cleared. 

If only the first parameter is given, only the specified breakpoint will be cleared. 

If only the second parameter is given, breakpoints through the specified ending breakpoint will 
be cleared. 

Description: If an attempt is made to clear a breakpoint that has not been set, the command is 
ignored. 

Error message: 

DPI 3 A breakpoint index greater than the maximum possible 
index number (3) was specified, or the ending break- 
point index was less than the starting breakpoint 
index number. 



r 
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Examples: 

. CB 1,3 ^ 

.CB 

The first example clears all breakpoints except number 0. The second example clears all • 

breakpoints. 

9.6.7 COMMUNICATIONS REGISTER UNIT COMMANDS (IC, MC). Commands to control the 
990 I/O port (the Communications Register Unit) are explained in the following paragraphs. 

9.6.7.1 Inspect CRU Input Lines (IC). The Inspect CRU Input Lines command is used to display 
in hexadecimal format the contents of one or more consecutive CRU locations. 

Syntax definition: 

IC [k I r<CRU address lower limit>| fj ' j <CRU address upper limit>J J ^ 

The command is terminated by a carriage return. 

Parameters: 

CRU lower limit CRU address that begins the display. The 

address must be in the range of to 1 FFFi^ . 
(1-4 hexadecimal characters.) 

CRU upper limit CRU address that ends the display. The 

address must be in the range to IFFFig . 
(1-4 hexadecimal characters.) 

Parameter default values: 

If the CRU lower limit is not specified, a value of is used. 

If the CRU upper limit is not specified and the CRU lower limit is specified, the default value is the 
CRU lower limit. Sixteen bits are displayed. 

If neither parameter is specified, the entire CRU is displayed. 

Description' Data is displayed in groups of four words, two groups per line. The address of the 
first word on the line is printed on the left. The display may be terminated at any time by pressmg 
the ESC key on the terminal keyboard. 

The address displayed is the actual CRU bit address times two. 
Error message: 

DPI 3 The highest CRU address specified is less than the lowest 

CRU address specified, or the highest CRU address specified 
is greater than the highest CRU address permitted (IFFF16). 



./<s^i^ 
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Examples: 



AC 1000 1060 

1000=FFFF FFFF FFFF FFFF 



.IC 100 



0100=6080 



In the first example, the CRU bits at addresses lOOOi^ through IO6O16. in 20i6 bit increments, are 
displayed. Since the CRU addresses are twice the actual bit addresses, the address of the next lOi^ 
CRU bits would be a 20i6 address increment. In the second example, the 16 CRU bits at location 
100 16 are displayed. 

Example: 



.IC 
0000=600D 


FFFF 


FFFF 


40DF 


>0000 


8001 


ODOO 


409B 


0100=FFFF 


FFFF 


FFFF 


FFFF 


>FFFF 


FFFF 


FFFF 


FFFF 


0200=FFFF 


FFFF 


FFFF 


FFFF 


>FFFF 


FFFF 


FFFF 


FFFF 



/^^\. 



9.6.7.2 MODIFY CRU REGISTER (MC). The Modify CRU Register command reads and displays 
the data on CRU input lines, and sets data on CRU output lines. 

Syntax definition: 
^ MC [j^ } [<CRU address>] [g } <CRU width>ll 

The command is terminated by a carriage return. 

Parameters: 

CRU address The CRU word address. A value from to 1 FFFi^ . 
(1-4 hexadecimal characters.) 

f^ CRU width The number of bits to be changed in each CRU 

word (hexadecimal). A value from 1 to lOia- A 
value of is interpreted as lOx^. (1-2 hexadecimal 
characters.) 

Parameter default values: 

If the CRU word address is not specifled, a value of is used. 

If the CRU width is not specified, a value of lOi^ is used. 

Description: When the CRU bit width is less than 16 bits, the data value is displayed right 
justified in a four-digit hexadecimal value. The user's data may be input as a four-digit value; the 
rightmost bits, where the bit width is given by the CRU width parameter, are used to modify the 
CRU value. Enter a new value to change the value, a space to continue on to the next value, and 
f^^- a carriage return to terminate data modification. 
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The addresses are displayed as they would be used in workspace register 12 (the CRU base 
address), which is the actual CRU bit address times 2. Also, data is displayed and entered 
directly as the STCR/LDCR instruction receives/sends it. 

If the CRU word address is greater than IFFFi^, the command is ignored. 
Error message: 

DPI 2 CRU bit width parameter too small (negative) or too 

large (greater than lOig ). Invalid bit string width. 

Application note: The Modify CRU Register command may be used to change the data being 
sent to an external device during the debugging of a new interface. 

Examples: 

, MC 1000 8 

1000=00FF 0080 

1010=00FF 0040 ^ 

. MC 1000 
1000=FFFF 1000 

9.6.8 MEMORY COMMANDS (IM, MM). The commands explained in the following paragraphs 
allow user knowledge and control of memory contents. 

9.6.8.1 Inspect Memory (IM). The Inspect Memory command is used to display in hexadecimal -^^ 

format the contents of one or more consecutive memory locations. ' 

Syntax definition: 

IM I y I <starting mem addr> Q^ | <ending mem addr>| J 

The command is terminated by a carriage return. 

Parameters: ^ 

starting mem addr Hexadecimal value representing the memory 
address of the first memory word displayed. 
(1-4 hexadecimal characters.) 

ending mem addr Hexadecimal value representing the memory 

address of the last memory word displayed. 
(1-4 hexadecimal characters.) 

Parameter default values: * 

If neither parameter is specified, all memory is dumped. 

If the ending address is not specified, only one word is displayed. 

An odd address is changed to the preceding word address before the addressed byte is displayed. 
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Description: Memory is displayed in groups of four words, two groups per line. The address of 
the first word on the line is printed at the left. The display may be terminatecj at any time by 
pressing the ESC key on the terminal keyboard. 

Error message: 

DPI 3 The ending address specified is less than the 
starting address specified. 

Examples: 

. IM 1000.1004 
1000=1002 COEO 023E 

JM 1006 
1006=1004 

9.6.8.2 MODIFY MEMORY (MM). The Modify Memory command displays the address and 
contents of a memory word and accepts a new hexadecimal data value from the user. 

Syntax definition: 

MM jv I <memory address> 

The command is termhiated by a carriage return. 

Parameter: 

memory address Address of memory to be modified. 

Parameter default value: If the memory address is not specified, a value of is used. 

Description: If the user inputs a new value, the memory location is modified to match the input 
value. If the user terminates his input with a blank (space), the iiext location value is printed and 
^ the process repeated. If the user terminates his input with a carriage retum or comma, the 

command processing terminates. 

Error message: 

DPOO An invalid hexadecimal value was input. 

-6. 

Application note: The MM command is useful for setting up desired conditions in order to check 
out a routine. It is also convenient for creating patches and for examining memory one word at 
a time. 

Example: 

MM 1000 
_^ 1000=FFFF 1 

r" 1002=FFFF 3 

1004=FFFF 
1006=FFFF 8 
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These command statements place the vakie 1 m location 1000, 3 in location 1002, and 8 in location 

1006. The user may enter a space (blank) if he does not want to modify a location but wants to go ^^^ 

on to the next location. A carriage return terminates the command at any time. 

9.6.9 PROCESSOR REGISTER COMMANDS (IR, MR). The following commands allow control 
of the 990 computer program control registers: the program counter, workspace pointer, and status 
registers. * 

9.6.9.1 Inspect Registers (IR). The Inspect Registers command displays the contents of the user's 
registers: the program counter (PC), workspace pointer (WP), and status (ST) registers for the 
current user program. These values are displayed in groups of four hexadecimal characters. 

Syntax definition: 

IR 
The command is terminated by a carriage return. 



Application note: The displayed register values are those values which are loaded into the processor '^ 

in response to an EX or RU command. 

Example: 

.IR 

PC=0246 WP=0000 ST=0000 

9.6.9.2 Modify Registers (MR). The Modify Registers command displays the contents of the -^ 

user's internal registers -- workspace pointer (WP), program counter (PC), and status (ST) 
registers - and allows the user to modify them. 

Syntax definition: 

MR 

The command is terminated by a carriage return. 



Description: The register name and current contents are printed in hexadecimal and a hexadecimal 
input is accepted from the user. If the user inputs a vahd hexadecimal number, the contents of the 
registers are changed. If the user enters a space, the processor prints the name and contents of the 
next register. If the user enters a carriage return, the command terminates. 

Error message: 

DPOO An invalid hexadecimal number was input, or the 
number input was greater than FFFFie. 

Application notes: Modification of the Workspace Pointer (WP) register causes the registers that 
would be displayed by the Inspect Workspace Registers (IW) command to change. The Modify 
Registers command is used to establish the initial environment for a program executed with the 
Execute User Program Directly (EX) or the Execute User Program under SIE or Trace (RU) 
command. 
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Examples: 
.MR 



PC=2000 244 
WP=0000 A6 
ST=0000 



. MR 

PC=0244 
WP=00A6 A2 
ST=0000 2 



.MR 
PC=0244 246 



The first example changes the value in the PC register to 244 1^ and the value in the WP register 
to A6i6. The second example changes the WP register value to A2i6 and the ST register value 
to 2,5. The third example changes the PC register value to 246 j^. 

As in the second example, the user may press the space bar on the terminal keyboard if he does 
/^^ not wish to modify a particular register. As in the third example, he may press the RETURN 

' key on the terminal keyboard after entering a new PC register value to terminate the command. 

9.6.10 WORKSPACE REGISTER COMMANDS (IW, MW). The following commands allow precise 
control of the memory area selected to be the workspace registers. 

9.6.10.1 Inspect Workspace Registers (IW). The Inspect Workspace Registers command is used to 
display the contents of a sequence of the user's workspace registers. 

/^^ Syntax definition: 

IW I ' I <starting reg number> 1 1 ' [ <ending reg number> 1 1 

The command is terminated by a carriage return. 

Parameters: 

starting reg number The number of the first workspace register to be 
* displayed. Single hexadecimal number. 



ending reg number The number of the last workspace register to be 
displayed. Single hexadecimal number. 
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Parameter default values: 

If the starting workspace register is not specified, a value of 0, signaling register 0, is used. 

If the ending workspace register is not specified, the value used is the starting workspace register. 

If neither parameter is specified, all 16 registers are displayed. 

Description: The set of workspace registers displayed are those pointed to by the WP that would 
be displayed if an IR command were executed. Workspace registers are displayed with the 
register number preceding the register contents. 



Error message: 



DP 13 Either the starting workspace register number is 

greater than the ending workspace register number, 
or a workspace register number greater than F15 
was requested. 

Examples: 

JW 

RO^HXX) R1=0000 R2=0026 R3=0000 R4=0000 R5=2032 R6=0000 R7=0000 

R8=0000 R9=0000 RA=0000 RB=0000 RC=0000 RD=3798 RE=2008 RF=0002 

If no workspace register or range is specified, all 16 registers are printed. 

. IW 2.8 

R2=CMXK) R3=0000 R4=0000 R5=0000 R6=0000 R7=0000 R8=0000 

. IW2 
R2=0000 



^ 
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9.6.10.2 Modify Workspace Registers (MW). The Modify Workspace Registers command is used to 
display and change the contents of one or more of the user's workspace registers. 

Syntax definition: 

MW I ' I < starting reg number >J 

The command is terminated by a carriage return. 
Parameter: 

starting workspace reg The number of the first workspace register 

to be displayed. (Hexadecimal value.) 
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Parameter default value: 

If the starting workspace register is not specified, register zero is assumed and a value of is used. 

Description: The mnemonic and current contents of the workspace registers are displayed. The 
command processor accepts the user's input, which may be a new hexadecimal value for the register 
contents and a terminator. If this input is a new value, the current contents of the specified register 
are changed. If the terminator is a blank, the next register is printed for modification. If the 
terminator is a carriage return or comma, the command processing terminates. The command 
processing terminates automatically after processing workspace register 15 (Fjg). 

Application note: The user is cautioned to be sure that the workspace pointer actually points to 
the intended workspace. The Modify Workspace Registers command displays the registers within 
the current workspace (the workspace defined by displaying the WP in an IR command). 

Example: 

. MW4 
R4=0(X)0 7 
R5=0000 89 
R6=0000 
R7=0000 1000 

This example changes the contents of workspace registers R4, R5 and R7 to 7i6, 89 1^ and 
IOOO16, respectively. A carriage return was entered after changing the contents of R7. 

9.6.1 1 SNAPSHOT COMMANDS (SS, IS, CS). The following commands provide a convenient way 
to specify debugging information to be displayed. 

9.6.11.1 Set Snapshot (SS). The Set Snapshot command is used to define a set of registers and 
memory locations to be displayed as a single unit. 

Syntax definition: 
(^ ^^ lb...l [<snapshot no.>J [j^ j [<starting reg no.>J [{^ } [<ending reg no.>] 

Lib...] pt^rt"^8 memory addr>J [^g | <ending memory addr>J J J J 

The command is terminated by a carriage return. 
Parameters: 

snapshot no. Index number of snapshot to be defined. 

The index is a number in the range 0-3. 

starting reg no. First workspace register to be displayed. 

ending reg no. Last workspace register to be displayed. 

( starting memory addr First memory word address to be displayed. 

ending memory addr Last memory word address to be displayed. 
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^"23 Digital Systems Division 



o 




946258-9701 



^ 



^ 



Parameter default values: 

If the snapshot number is not specified, a value of is used. 

If the starting workspace register number is not specified, a value of is used. 

If the ending workspace register number is not specified, the value used is the starting register 
number if the starting register number is specified. Otherwise, the value is 0i6 . 

If the starting memory address is not specified, a value of is used. 

If the ending memory address is not specified, the value used is the starting memory address if the 
starting memory address is specified. Otherwise, it is 0i6 . 

Description: Snapshots may be invoked with the Inspect Snapshot (IS) command or when a 
breakpoint which references the snapshot index is encountered. 

Error messages: 

DP03 A parameter is greater than the required maximum value. 
Reenter the command. 

DP04 Snapshot is already defined. Reenter the command. 

DPI 3 The ending parameter (register or memory address) is 
less than the beginning parameter. 

Application notes: Snapshots are convenient for defining a frequently used display during a debug ""^ 

session. If certain registers or memory data areas are frequently modified, they are likely choices 
for snapshots. 

Since a snapshot may be attached to a PC breakpoint to dump some data and continue 
execution, a trace can be constructed which will be activated only when some specified event 
occurs. A dump may be produced and execution will continue without operator intervention. 

Snapshots are useful for extended traces when the user wants to leave the computer running 
with breakpoints established. This would allow the computer to do an automatic dump when 
an exceptional condition is encountered and then continue execution. 

Examples: 

. SS 1,2,5.1000,1002 

. SS 0,0,F 

In the first example, the snapshot associated with index 1 displays workspace registers 2 through 
5 and memory locations IOOO16 through 1002i6. In the second example, the snapshot asso- 
ciated with index displays workspace registers through F15 and memory address (the 

default). Refer to the IS command examples in paragraph 9.6.11.2 for the corresponding 
commands. 
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9.6.11.2 Inspect Snapshot (IS). The Inspect Snapshot command is used to display sequences of 
^^ workspace registers and memory addresses. 

Syntax definition: 

IS 11' I Kstarting snapshot no.>J v | <ending snapshot no.>j J 
The command is terminated by a carriage return. 

Parameters: 

starting snapshot no. Index number (number of the snapshot in 

sequence) of the first snapshot to be 
displayed. A number from to 3. 

ending snapshot no. Index number of the last snapshot to be 
^ displayed. A number from to 3. 

Parameter default values: 

If neither the starting snapshot number nor the ending snapshot number is specified, all 
snapshots are displayed. 

If the starting snapshot number but not the ending snapshot number is specified, the named 
snapshot is displayed. 

If the ending snapshot number but not the starting snapshot number is specified, the snapshots 
from through the specified snapshot are displayed. 

Description: Snapshots are defined with the Set Snapshot conwnand. Attempts to display 
undefined snapshots are ignored. 

Error message: 

DP 13 Either the ending snapshot number is greater than 
^ the starting snapshot number, or a snapshot number 

greater than the permitted maximum was input. Re- 
enter the command with the correct snapshot numbers. 

Examples: 

.IS 

SNAPO 

R0=0000 R 1=0000 R2=0000 R3=0000 R4=0007 R5=0089 R6=0000 R7=0000 

R8=0000 R9=0000 RA=0000 RB=0000 RC=0000 RD=0000 RE=0000 RF=0000 

0000=0000 

SNAP1 

R2=0000 R3=0000 R4=0007 R5=0089 

1000=0001 0003 
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. IS 1.3 

SNAP1 .."^ 

R2=0000 R3=0000 R4=0007 R5=0089 ^ 

1000=0001 0003 



^""^ 



.IS 3 



The snapshots in these examples were set in the examples of the Set Snapshot (SS) command 
(paragraph 9.6.1 1.1). In the last example, if a snapshot is not set, the monitor will return control 
without printing anything. 

9.6,1 1.3 Clear Snapshot (CS). The Clear Snapshot command is used to disable previously specified 
snapshots. 

Syntax definition: 

CS U [ Kstarting snapshot number> 1 N ' 1 <ending snapsnot number>l 1 

The command is terminated by a carriage return. 

Parameters: 

starting snapshot number The first snapshot to be cleared. A 

number from to 3. 

ending snapshot number The last snapshot to be cleared. A 

number from to 3. 

Parameter default values: 

If no parameters are specified, all snapshots are cleared. 

If only the first parameter is given, only the specified snapshot will be cleared. 

If only the second parameter is given, snapshot through the specified ending snapshot will be ^ 

cleared. 

Description: If an attempt is made to clear a snapshot that has not been set. the command is 
ignored. 

Error message: 

DP] 3 A snapshot index greater than the maximum possible 
index number (3) was specified, or the ending snap- 
shot index was less than the starting snapshot index 
number. 

Examples: 

. CS 0.2 

. CS 2 
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In the first example, all snapshots except index number 3 are cleared. In the second example, 
only snapshot 2 is cleared. 

9.6.12 TRACE COMMANDS (ST, SR, CR) 

The following commands allow precise control of regions to be examined in detail during a debug 
session, including specification of the information to be displayed. 

9.6.12.1 Set Trace Definition (ST). The Set Trace Definition command defines parameters that 
determine what information about instruction trace regions will be printed. There are up to four 
different trace formats that may be defined, any one of which may be associated with one or more 
"trace regions". The format determines what is to be displayed for each instruction traced in the 
associated region. 



L) 



Syntax definition: 

ST I ' I <fonnat index> |' | <char string> 

The command is terminated by a carriage return. 
Parameters: 

format index Trace format index number; a number 
from to 3. 

char string Character string describing the options 

to be printed. The string contains from 
1 to 27 characters. 

Parameter default values: There are no default values. Both parameters are required. 

Character string symbols: The character string symbol definitions and the associated trace 
printouts are as follows: 



Character Trace Output 
F XXXX 

} F-lIU 



M 



W 



ST-)OCXX 



WP-XXXX 



BT'-XXXX 



Description 

Program counter. The program counter is printed for every instmction exe- 
cuted. The program counter value is printed if anything else is printed even if 
'P" was not specified (example 1). 

instruction and format. (Instruction Tormats are described in the Model 990 
Computer 77^89900 Microprocessor Assembly Language Programmer's Guide, 
Manual No. 943441-9701.) The instruction and its format are printed for each 
instruction executed (example 2). 

Status mask. The contents of the status mask whicli is placed in the user sta- 
tus register is printed after each instruction executed (example 2). 

Workspace pointer ;haages. ^Mien the user's -workspace ciianges, the new 
workspace is printed. 

Targets for branch or jump instruction. Wlienever a branch or jump occurs, 
the target address of the branch/jump is printed. 
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Description 

CRU address. When one of the instructions that references the CRU (LDCR, 
STCR, TB, SBO, SBZ) is executed, the address of the first bit referenced is 
printed. For example, for TB 2, the address is base (=R12) + 2. 

Null trace. No printout occurs. If any other characters occur in the string, the 
null trace is overridden. 

XOP level. When an XOP instruction is executed, the XOP level is printed. 

Source. Refers to the source register. It is followed by an E, B, A or R. 

Source effective address. This address is the memory location that the source 
field addresses. It is printed for every instruction (example 2) that has a 
source operand. 

Contents of source effective address before execution. The contents of the 
source effective address before execution are printed for every instruction 
(example 2) with a source operand. 

Contents of source effective address after execution. The contents of the 
source effective address are printed after each instruction with a source 
operand is executed (example 2). 

Contents of source workspace register after execution for T, = 3 (indirect 
addressing with autoincrement). (T^ is the source addressing mode field in an 
assembly language machine instruction.) The contents of the source register 
is printed if an autoincrement is specified. 

Destination. Refers to the destination. It is followed by an E, B, A or R. 

Destination effective address. This address is the memory address that the 
destmation field addresses. The destination effective address is only printed 
for Format 1, 3, and 9 assembly language machine instructions. All other 
instruction format types do not have a destination field (example 2). 

Contents of destination effective address before statement executed. This is 
printed whenever a destination field exists (example 2). 

Contents of destination effective address after execution. This is printed 
whenever a destination field exists (example 2). 

Contents of destination workspace register after execution for T^j = 3 (in- 
direct addressing with autoincrement). (T^j is the destination addressing mode 
field in an assembly language machine instruction.) The contents of the 
destination register is printed if an autoincrement is specified. 



Character 


Trace Output 


C 


C=XXXX 


N 


(null) 


X 


x-xxxx 


s 




E 


SE=XXXX 


B 


SB=XXXX 


A 


SA=XXXX 


R 


SR=XXXX 



D 
E 



DE=XXXX 



B 


DB=XXXX 


A 


DA=XXXX 


R 


DR=XXXX 
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Description: The character string is scanned for proper syntax. If the string conforms to the 
syntax, a trace print control template is built and placed in the trace format table. 

The character string in the ST command allows the user to select only those portions of the 
trace output that he needs. For tutorial purposes, an extensive trace output could be requested, 
while minimal traces such as a PC or variable trace are also easily selected. Each character in the 
character string represents a desired portion of the trace. 

If any trace option other than PC is printed, PC is also printed. 

A trace on a variable (see ST command) is implemented by specifying the desired variable. 
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The character string is scanned from left to right. The characters E, B, A and R are modified by 
the most recent occurrence of S or D. If E, B, A or R is encountered before an occurrence of S 
or D, or if an invalid character is encountered, the scan is aborted and an invalid syntax message 
is issued. A character string consisting entirely of S or D is also an invalid syntax. 

All four trace format table elements have initial values as follows when the debug monitor 
overlay containing the ST command is loaded: 

Index Number Equivalent Character String 

P 

1 PIWSEADEA 

2 T 

3 PIMWTCXSEBARDEBAR (all trace output options) 



■^^ Error messages: 



DP23 Syntax error in trace format character string. 
Reenter the command. 

DP26 Invalid trace format index number. Reenter 
the command. 

Examples of typical character strings: Some examples of typical character strings are presented 
here. To invoke a PC trace, the character string is 

P 

If a branch trace is desired, the character string is 

T 

The character string for a trace that includes PC, instruction and format, workspace pointer 
changes, and source and destination effective addresses is 

PIWSEDE 

To specify all options, the character string is the same as the string equivalent to default trace 
format index number 3 (above). 

Example 1: Trace format 1 in the following example is defined as a program counter trace. The 
program counter is the only option printed. 
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. ST 1.P 

■ SR 1. 0.2000.1. N .-V 

.MR ' 

PC=198C 46C 

.RU 

046C 

0470 

0474 

1A92 

1A96 

198C 

198E 

1992 

1994 

1996 

Example 2: This example shows the trace format index number 1 set to a full trace. 

. ST 1.PIMWTCXSEBARDEBAR 

. SR 1.24C.260.1.S 

.MR 

PC=0250 24C 
.RU 

024C 8-02E0 ST=0000 SE=00A6 SB=024C SA=024C ^^ 

0250 6-04E0 ST=0000 SE=01FC SB=0054 SA=0000 ' 

0254 6-04E0 ST=0000 SE=01B4 SB=C259 SA=0000 

0258 6-04E0 ST=0000 SE=01B8 SB=C060 SA=0000 

025C 6-0720 ST=0000 SE=01BA SB=01E6 SA=FFFF 

0260 1-C820 ST=COOO SE=021E SB=109A SA=109A DE=00D2 
DB=1850 DA=109A 

9.6.12.2 Set Trace Region (SR). The Set trace Region command defined a trace region. 
Syntax definition: 

^^ lb..i ^^^^" index> |^ | <lower mem addr> t j <upper mem addr> 
[^ j <format index> [{^ J |<step region>| [{^ ) <vl> [{fe ) <v2> 

OlJH]]] 



The command is terminated by a carriage retum. 



/f^^^ 
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^^P^ 



/|W^ 



j^PlN 



Parameters: 



region index 



lower mem addr 



upper mem addr 



format index 



step region 



vl, v2, v3 



Trace region index number; a number from 
to 3. 

First memory address in the trace region; 
a hexadecimal number in the range to 
FFFE. 

Last memory address in the trace region; 
a hexadecimal number in the range to 
FFFE. 

Trace format index number; a number from 
to 3. 

If this field contains S, an instruction 
step region is specified. If it contains 
N, the field specifies no instruction step. 
Any other character specifies no instruc- 
tion step. 

Addresses of variables to be traced while 
in the designated region. Up to three vari- 
ables may be specified. The range of values 
for each variable is to FFFE 15. In the 
printed trace data, only changes are shown. 

Parameter default values: 

The first four parameters in the syntax definitions are required. 

If the step region parameter is not specified, a value of N is used. 

If none of the parameters vl, v2, and v3 are specified, no variables will be traced in the 
designated region. 

Description: The specified regions of memory are designated as the program area to be executed 
under control of the interpretive trace. 

The trace region index number determines which trace type will be executed as defined by the 
Set Trace Definition (ST) command. If two overlapping regions have been defined, the region 
with the lowest index has precedence and the trace type defined in that region is executed. (See 
example 1.) 

The trace format index number indicates the trace type vector assigned to the trace region. When 
the trace overlay is loaded, each of the four trace type vectors, indices through 3, is assigned 
an initial value. These vectors may be modified by the Set Trace Definition (ST) command. 
Trace types may vary from a null trace to a full trace. 

The function of the instruction step region is to control the execution of the user program. If 
the instruction step region is set by entering an S parameter on the terminal keyboard, only one 
instruction at a time will be executed and traced. To execute another instruction, the user must 
press the space bar. 
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If variables have been specified to be traced, only changes will be printed. The format of the 
output is: 

AAAA = DDDD 

Where AAAA is the address of the variable and DDDD is the new value of the variable. These 
are hexadecimal values. 



^ 



Error messages: 

DP 13 The specified last memory address was less than the 
first memory address. Reenter the command. 

DP 10 Invalid trace region index number. Reenter the command. 

DP26 Invalid trace format index number. Reenter the command. 

Example 1: This example shows the setting of two different trace regions, one a PC trace and 
the other a full trace. The region with the lower index is executed when the two regions overlap. 
In this manner, the user can get a general trace until he reaches a critical section of the program 
where he wants everything traced. 

. ST 1.PIMWTCXSEBARDEBAR 

■ ST 2.P 

. SR 2.0.2000.2.N 

■ SR 1.24C.260.1.S 

.MR 



PC=0250 

.RU 

0246 

024A 

024C 

0250 

0254 

0258 

025C 

0260 



246 



/'^^Sk 



8-02E0 
6-04E0 
6-04E0 
6-04E0 
6-0720 
1-C820 
DB=1850 



ST=0000 
ST=0000 
ST=0000 
ST=0000 
ST=0000 
ST=C000 
DA=109A 



SE=00A6 
SE=01FC 
SE=01 84 
SE=01B8 
SE=01BA 
SE=021E 



SB=024C 
SB=0054 
SB=C259 
SB=C060 
SB=01 E6 
SB=109A 



SA=024C 

SA=0000 

SA=0000 

SA=0000 

SA=FFFF 

SA=109A 



DE=00D2 



0266 
026A 
0270 
0274 
0278 
027A 
027E 



Outside the critical region, a continuous run is desired. Inside the critical region, there is a single 
instruction step. The operator must press the carriage return or space bar on the terminal 
keyboard after each statement executed. 



y<1«^%V 
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Example 2: The trace region is set from to 2000i6, with the trace format index number equal 
to 3. (Trace type 3 defaults to a full trace.) The snapshot prints workspace registers 1 through 4 
and memory locations lOOOi^ to 1004i6. A breakpoint is set at 0474 j^ with snapshot 1 
associated. A Modify Registers (MR) command sets the program counter to 046Ci6, ^^^ 
execution is begun by issuing an Execute User Program under SIE or Trace (RU) command. 



. SR 1,0,2000,3,N 

. SS 1,1 A1 000.1004 
. SB 1,474„1 
.MR 



^0^i\ 



PC=198C 46C 

.RU 

046C 8-02E0 

0470 1-C2A0 



ST=2000 WP=044C SE=1968 SB=0900 SA=0900 
ST=C000 SE=00A6 SB=1A92 SA=1A92 DE=0460 
DB=0000 DA=1A92 

BKPT#1 

PC=0474 WP=044C ST=C000 

SNAP1 

R 1=11 CO R2=0000 R3=0000 R4=0000 

1000=1008 C145 1305 

0474 6-045A ST=C000 BT=1A92 SE=1A92 SB=C2A0 SA=C2A0 

1A92 1-C2A0 ST=2000 SE=00A8 SB=0000 SA=0000 DE=0460 
DB=1A92 DA=0000 

1A96 6-0420 ST=2000 WP=1968 BT=198C SE=1988 SB=1968 

SA»1968 
198C 6-04C3 ST=2000 SE=196E SB=FFFF SA=O00O 
198E 1 



Following is a listing of the portion of the program executed in this example with all references 
resolved: 



Sooice 

LWPI MAINW 
MOV @ENTRY,R10 
B 'RIO 



Memofy 
Location 


Object 
Code 


046C 
046E 
0470 
0472 
0474 


02E0 
044C 
C240 
00A6 
045A 


1A92 
1A94 
1A96 
1A98 


C2A0 
00A8 
0420 
1988 


1988 
198A 
198C 


1968 
198C 
04C3 



INIT MOV @KBLUNOJ110 

BLWP @OPEN 



OPEN 


DATA 


lOWKS 




DATA 


OPENl 


OPENl 


CLR 


R3 
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This is a typical example using snapshots, breakpoints and an instruction trace. Since a snapshot 

is associated with the breakpoint, the snapshot is printed and execution continued. An exit from ^"^ 

the RU command is made by pressing the ESC key on the terminal keyboard. 

9.6.12.3 Clear Trace Region (CR). The Clear Trace Region instruction is used to disable previously 
specified trace regions. 

Syntax definition: 

CR k I <starting trace region>| I ji | <ending trace region> I 

The command is terminated by a carriage return. 

Parameters: 

starting trace region The first trace region to be cleared. 

A number from to 3. ^ 

ending trace region The last trace region to be cleared. 

A number from to 3. 

Parameter default values: 

If no parameters are specified, all trace regions are cleared. 

If only the first parameter is given, only the specified trace region will be cleared. 

If only the second parameter is given, trace regions through the specified ending trace region 
will be cleared. 

Error message: 

DP 13 A trace region index greater than the maximum possible 
index number (3) was specified, or the ending region 
index was less than the starting region index number. 

Examples: "^ 

. OR 1,3 

.CR 
In the first example, all but region are cleared. In the second example, all regions are cleared. ^ 

9.6.13 WRITE PROTECT OPTION COMMANDS (SP, CP) 

These commands allow control of the optional hardware memory write protect feature on 990/4 
computers. 



^ 
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/^^^^ 



jM^»!S 



/i#i^ 



9.6.13.1 Set Write Protect Region (SP). The Set Write Protect Region command sets the write 
protect region to the address specified in the command. This command is only valid if the user has 
a 990/4 computer with the write protect option. A protection violation generates a general inter- 
rupt signal which may be wired to any available interrupt level. Refer to the Model 990/4 Computer 
Computer System Hardware Reference Manual for the procedure for wiring a memory board to a 
desired interrupt level. 

To set a write protect region, the lower and upper bounds must be output to CRU base address 
IFAO16. The most significant bit (bit 0) is the Protect/Permit bit. Bit 0, when set to 1, indicates 
write permit, and, when set to 0, indicates write protect. To specify the protect region, memory is 
divided into 256-word blocks. The lower and upper bounds are each seven bits long and serve as 
an index into the memory addresses to specify which contiguous 256-word block of memory is to 
be protected. For example, the lower bound of the protect region equal to 2000i6 would be 
represented in the Protect register as IO16. The memory block beginning at location 2000i6 is the 
sixteenth 256-word (512-byte) memory block. A bound is calculated by dividing the starting ad- 
dress of the memory block by 200i6 (5 12 10). In this example, 2000i6 divided by 200i6 is equal 
to IO16. The upper bound is not included in the protect region. When outputting to the CRU 
Protect register to specify the protect bounds, a Load CRU (LDCR) instruction with a count of 16 
must be used to set all 1 6 bits because the Protect register works like a shift register. To protect 
the memory range 2000i6 to 4000i6, the lower bound is set equal to lOi^, the upper bound is 
set to 2O16, and the Protect bit is set to 0. Therefore, the Protect register is set to 102Oi6 by out- 
putting these fields to the CRU in the format specified in figure 9-1 A. 



1 



8 9 



15 









^ 








P 


LB 


1 




UB 






I 

NOT 
USED 






BIT FIELDS 




p 


PROTECT /PERM IT BIT 
0- PROTECT 
1-PERMIT 




LB 


LOWER BOUND 




U 


B 


UPPER BOUND 









NOTES 

THE CRU OUTPUT DATA FORMAT IS THE SAME AS THE 
FORMAT OF DATA IN MEMORY BEFORE IN LDCR 
INSTRUCTION IS EXECUTED. 

BITS 1 AND 9 ARE THE MOST SIGNIFICANT BITS. AND BITS 
7 AND 1? ARE THE LEAST SIGNIFICANT BITS OF THE LB 
AND UB FIELDS. 



(A) 13337 3 



Figure 9-1 A. CRU Output Data Format 
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When an attempt is made to write into a memory location within the protected region, the Protect 
Violation flag is set to FFFF16 . This flag, which is normally 0, can be sensed by reading any of the ^ 

16 CRU bits at base IFAOie- If this protected region is within the TMS9900 on-board RAM, the 
write is not inhibited. If this protect region is on the expansion memory card, the write is inhibited. 

The Protect Violation flag may be cleared in two different ways: 

1. I/O RESET (RSET) - This machine instruction clears the violation flag and sets bit 
of the Protect register to 1 (not protected). 

2. Output a 1 to any or all of the 16 bits of the Protect register. 

If the user has wired his system such that a write protection violation causes an interrupt at a 
certain level, he must initialize the trap vector for that level and process the interrupt. The level 2 
trap vector is initiaUzed automatically by the Debug Monitor. The user may take advantage of this 
fact and wire his memory board interrupt to level 2. The system then prints: 

**MX06** ^ 

when a protection violation occurs. When this happens, a RSET instruction is executed and the 
user must reestabUsh the protect bounds before starting execution again. 

Syntax definition: 

SP L ' 1 <lower mem addr> I b'. . . 1 <^PP^^ ^^^ ^^^^^ 

The command is terminated by a carriage return. ''^ 

When the user issues an SP 0600,0800 and then an EX command, his program begins execution. 
Should the user program then attempt to write into memory location 0700, hardware write protect 
sets the protection violation flag in the CRU and interrupts the CPU if the user has wired that 
interrupt. 



Parameters: 

lower mem addr Lower boundary memory address of the protected 
region. Required parameter. Hexadecimal 
number. 

upper mem addr Upper boundary memory address of the protected 
region. Required parameter. Hexadecimal 
number. 

Description: This command sets the write protect region from the lower to the upper memory 
bound addresses. If the memory addresses entered are not on 256-word boundaries, the bounds 
will be set at the next lower 256-word boundary. The lower bound is included within the 
protect region but the upper bound is not. 

The SP command overrides any previously defined protect region. 



./i^^ 



^ 
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When the upper and lower bounds are sent to the CRU, the Protect Violation flag is cleared if it 
has been set. 

Error message: 

MS05 Parameter specification error. Either a required parameter 
is missing, or the lower bound is greater than or equal 
to the upper bound. 

Application note: This command is ignored if the write protect option is not implemented in the 
system hardware. 

Examples: 

. SP 1000,2000 

This command protects a region in memory from 1000,6 to IFFFie- 

. SP 1000JF00 

Tliis command protects a region from 1000,6 to IDFFi^. The address IFOOie is not a 
256-word boundary; therefore, the upper bound is set at the next lower 256-word boundary, 
lEOO. 
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9.6.13.2 Clear Write Protect Region (CP). The Clear Write Protect Region command clears the 
protect register and removes protection from the write-protected region. 



/■"^^V 



^ 



Syntax definition: 

CP 

The command is terminated by a carriage return. 

Description: The CP command clears the Protect register and sets the Protect/Permit bit to Permit. 
The Protect Violation flag is cleared if it has been set. 

Application note: This command is ignored if the write protect option is not implemented in the 
system hardware. 

Example: 

.CP 

9.7 DEBUGGING TECHNIQUES 

Debuggmg techniques may be divided into three basic categories: 

1. Preventive techniques - those which may be used to decrease the number of errors. 
Most of these techniques emphasize simphcity. Code should be simple and straight- 
forward enough to make it obvious that the program works. 

2. Exposure techniques - those which may be used to make the operation of a program 

easier to follow during the debugging process. ""^h 

3. Remedial techniques - those used when a bug occurs in the user's program. Typically, 
most programmers' efforts are expended on these techniques. 

Programming effort devoted to avoiding errors or making them apparent is important. Debugging 
and maintenance represent the majority of the cost in software development and support. The 
following paragraphs brietly discuss debugging in general and the specifics of debugging under 
I TXDBUG. 

9.7.1 GENERAL DEBUGGING TECHNIQUES. Several debug techniques will be helpful to the -^ 

programmer in any debugging situation. These paragraphs offer some suggestions about debugging 
a program under development. 

9.7.1.1 Debug Code in the Source Program. Include debug code in the source program. The user 
should keep the testing process in mind from tlie moment he starts to create a program. When 
referencing or changing data, the programmer should consider how to tell if the change is correct - 

when reconstructing the results of a run. This often involves being aware of what intermediate 
results of a computation are lost. 

For example, if the value of a variable D is calculated by the statement 

D = A + B 
and the program later encounters the statement 

D = C + D 



^ 
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the second statement will cause a new value D to replace the previously calculated value. The 
calculated sum A + B will therefore be lost. If, on the other hand, the program contains the 
statement 

E = A + B 

and, later in the program, the statement 

D = C + E 

the value of E will be preserved when D is calculated by the second statement. The programmer 
can examine the memory location containing the value of E to determine the calculated sum A + 
B. 

After a computation is completed, reconstruction of the results of a program run involves 
distinguishing which decision paths have been taken through the program's code and determining 
what variables are relevant in calculating the results of a computation. 

When the source code is written, it is often simple to store intermediate results in extra memory 
to record those results, branch paths, or the number of passes through loops. Such statements 
can be flagged with a character string (e.g., **DEBUG**) in the comment field. When the source 
code is ready for production, TXEDIT can be used to locate and remove the code that stores 
intermediate results. 

9.7.1.2 Oiecking the Program. Once a program has been successfully assembled, a thorough 
check of the program can often turn up errors which are hard to detect when the program is 
executing. In addition to making sure that the program is a correct implementation of the 
algorithm, it is often worthwhile to read through the program looking for specific errors: 

• Register errors. Using the wrong register; referencing a register not in the current 
workspace; using a register as an inunediate value (e.g., AI R1,R2 instead of A R1,R2 
or AI Rl,2); using byte-level operations or data where the data is in the wrong half of 
the register; or using byte-level data with the other half of the register containing 
incorrect data which affects the computation. 

• Variable names. Misspelling of variable names such as TO and TO; or using a smgle 
variable to contain different quantities. 



# 



Initialization errors. Referencing values which may not have been properly initialized. 
This often occurs when a program is re-executed. 

Buffer initialization. Omitting an instruction to clear an input buffer between input 
operations when variable length records are read into a common fixed4ength buffer. 

Branch conditions and loop terminations. Using the wrong branch instruction (espe- 
cially JH, JL, JGT, JLE, JLT, JHE, or JOC with subtracts); or executing a loop one 
time too many or one time too few. 

Inconsistent techniques. Using conventions or debug elements which are inconsistent 
with the coding practice for the module. 
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• Module interfaces. Using variables or parameters which were not correctly set up for an 
interface; using registers or variables within a subroutine which have values that are not 
to be changed within the calling routine. 

• Boundary conditions. Checking that the full range of the possible input data to a 
computation is correctly processed by the algorithm. 

9.7.1.3 Execution Tree. In debugging or testing a program, it is often convenient to visualize 
the possible paths through the program, as a tree with each node of tfie tree representing a 
conditional branch. Exhaustive testing of a program would then require testing each possible 
path through the program under all inputs which follow that path. While it is impossible to test 
all paths of a typical program, examination of the various paths (or small sets of paths) may 
reveal errors in the original logic. 

9.7.2 SPECIFIC DEBUGGING TECHNIQUES. The following paragraphs describe techniques 
directed specifically to debugging under the debug monitor. 

9.7.2.1 Planning the Debugging Session. Know the status of the debugging effort at all times. As 
the user interacts with the program through the console, he should be careful to record any 
changes made to the program and to be aware of the state of the program when examining it. In 
a debugging session, the user should have a clear idea of what he wants to accomplish and how 
he intends to accomplish it. Decisions made in the process of debugging should be carefully 
thought out. 

9.7.2.2 Use of Breakpoints. There are three ways of stopping or interrupting the execution of a 
user's program which is being debugged at a specific location in the program: 

1. Set an instruction coimt on the RUN command. 

2. Execute with the single step option under instruction trace. 

3. Set appropriate breakpoints. 

Breakpoints stop execution at specific points in the user program rather than at arbitrary points 
controlled by the instruction count. The user may easily determine in advance and check the 
results of a computation without concerning himself about the state of the program. 

When using breakpoints, be sure that the program will actually reach the desired breakpoint. This 
may involve putting additional breakpoints on the other paths from conditional branches. 

Breakpoints are particularly useful when forcing some condition within a program which is not 
easily created from its parameters, for example, a CRU input. As an illustration of such a 
condition, an input value is to be read from a pressure transducer in an on-line process control 
environment. However, if the program is being debugged, a physically connected transducer is 
usually impractical and the values must be entered by the programmer. Breakpoints may be set 
prior to the start of a code sequence. When the breakpoint is taken, the user may set or modify 
the existing conditions in order to cause specific paths to be taken (as if a specific input had 
been received from the transducer). 

The breakpoint reference count can be used to see that a loop is repeated the correct number of 
times. By setting the reference count equal to the number of iterations through the loop and 
setting another breakpoint outside the loop, the user may check that the loop is exhausted on ,.«^ 

the correct iteration. Breakpoints with attached snapshots with dump debug data or key variables ) 

yield a good trace aimed at checking the specific progress of a computation. 
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9.7.2.3 Excluding Loops from Instruction Traces. When tracing a program with printout, it is 
sometimes desirable to exclude printing of small loops which are very frequently executed or 
which run for many iterations. (See figure 9-2.) These may be excluded by carefully choosing 
trace regions, which are areas where an instruction trace is to be run within a program. In 
determining which trace region is applicable (and thus what trace type to use), the system will 
find the first (lowest numbered) region containing the user's PC. By selecting a high numbered 
trace (3) for the main trace control and then setting regions within that large region with lower 
numbered traces which do not print, the user may prevent a large quantity of output where it is 
not wanted. 



An alternate mechanism is to allow the small loops to be executed by SIE and the remaining 
prggram traced. (See figure 9-3.) This can be done by setting trac^ regions to cover all of the 
program except the small loops or frequently executed parts. Sudi a mechanism works well 

unless the user is using XOPs (other than XOP 1 5 for debug monitor I/O) or interrupts which are 
processed differently by SIE and instruction trace. 



JBiss 



If the user is performing I/O by means of supervisor calls (XOP 15), this XOP is executed 
directly (without SIE or instruction trace). If XOP 15 is not used for program I/O, it is 
executed directly under SIE. 



/^^N. 



ydP^^ 



USER PROGRAM TRACE REGION 

DEFINITION 



PGM : 



I 



JMP A 



TRACE 
REGION 3 



CONTROLLING 
TRACE REGION 



REGION 3 



} 



TRACE 
REGION 2 



REGION 2 



REGION 3 



yJ^^W\ 



(A)133102 



Figuie 9-2. Trace Region Prece<tence of Lowor Region Number 
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USER PROGRAM 



TRACE REGION 
DEFINITION 



MODE OF 
EXECUTION 



-^ 



pgm: 



w TRACE 

^ REGION 1 



TRACE 



NO TRACE 
REGION 



SIE 



JMP 



TRACE 
REGION 2 



TRACE 



^ 



(A)133103 



Figure 9-3. Using Both Trace and SIE 

9.7.2.4 Simulating an Interrupt. A BLWP instruction may be used to control an interrupt routine 
which is being checked out. This can be handled with the following code sequence. The quantity 
"i" is the value to which "INTLVL" has been equated. 



Instruction 


Operand 


Generated Code 


LIMI 


INTLVL 


0300 

i 


BLWP 


@INTLVL*4 


0420 
4*i 



.^ 



^ 



JMP 



$ 



lOFF 



The LIMI sets the interrupt status to the correct level. The BLWP transfers control through the 
interrupt vector. 

9.7.3 PATCHING. Patching (attaching portions of code to existing program code) should be 
avoided if possible. 

During a debug session, it is generally necessary to make patches to object code; however, it is 
advisable never to leave patches in a completed program (or create ROM firmware from a 
program with patches). An object program for which there is no corresponding source program is 
inconvenient and troublesome. 

The following paragraphs cover patching techniques. The examples show how to patch a 
two-address instruction; this instruction is used: 






MOV *R1,*R2+ 
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Because of the number of items to be considered, patching a two-address instruction is one of 
the more difficult operations. There are two ways to approach it: building a bit image and the 
additive method. 

9.7.3.1 Patching by Building a Bit Image. In building a bit image, the user merely fills in each 
field in the 16-bit word on a bit-by-bit basis. When all fields are complete, the value is converted 
to hexadecimal for the patch contents. 

Example: 

Patch the following assembly language instruction: 

MOV *R1/R2+ 

by building a bit image. 

The MOV instruction has this format: 



OP 
CODE 

1 1 


B 


1 ™_l-l— l.- 


Ts 


s 
„,L-L-JI„- 



<^^^pwff\ 



Determine the bits that occupy each field. Starting with the op code field, the hexadecimal 
op code for a MOV instruction is COOO. The first three bits of this op code are IIO2; 
transfer these bits into the op code field. 

The Byte Indicator (B) field specifies whether or not the instruction is a byte instruction. 
The MOV instruction is a word instruction; therefore, this field is set to 0. (The B field is 
always for a MOV instruction.) Another way of specifying the same information would be 
to use the MOV or MOVB instruction (as appropriate) and a four-bit op code. 

The D field specifies the destination workspace register. The destination address is *R2+, 
which indicates workspace register 2 and the workspace register indirect autoincrement 
addressing mode. The addressing mode for the destination, II 2, is placed in the T^ field. 
Transfer the binary value of the register number, OOIO2, into the D field. 

Use a similar procedure for the source address, which is *R1. In this case, workspace 
register 1 is specified and the addressing mode is workspace register indirect. Therefore, 
transfer 01 2 into the T^ field and 0001 2 into the S field. 

The instruction field contents will now be: 



1 10 





1 1 


0010 


01 


0001 



Now read these 16 bits as a four-digit hexadecimal number. 



1 100 


1 100 


100 1 


0001 



C C 9 1 

The resulting hexadecimal number is the desired value. The patch value is CC91. 
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9.7.3.2 Patching by the Additive Method. The second approach to the patching problem is the 
additive method. With a little practice, the patch described in the first approach can be created a 
little faster by treating each of the fields as a hexadecimal number and adding the results to 
produce the patch. 

Example: 

Patch the same assembly language instruction as in the bit image example: 

MOV *R1/R2+ 

by using the additive method. This method involves adding hexadecimal values correspond- 
ing to each field to the instruction's op code to get the patch value. 

The programmer can think of a bit field value as being placed into the instruction word, 
right justified, and shifted left the number of bits necessary to move it to the appropriate 
field. This shift is equivalent to binary multiplication, so the bit field value times an 
appropriate multiplier will give a value to be added to similarly obtained values for other bit 
fields to yield a sum representing the contents of the instruction word. 

Recall that the values for the addressing modes and workspace registers in the previous 
examples were: 

Destination mode (T^) 3 

Destination register (D) 2 

Source mode (T^) 1 

Source register (S) 1 

In calculating the patch value by the additive method, these values are used. 

The first number in the calculation is the hexadecimal op code for the MOV instruction, 
COOO. The B field is always in the MOV instruction; it can be considered part of the 
instruction op code and ignored in the calculation. 

The second number to be added is the value of the destination mode. The code for the 
address mode is shifted left ten bits, equivalent to multipUcation by 400 1^. The code is 
3 16; therefore, the value to be added is ^ 

3 16 *400i6 =0C00i6 

The third number is the destination register value. To create the value to be added, the 
register number, 2i6, is shifted left six bits, equivalent to multipUcation by 40 16. The value 
is 

2i6 *40i6 = 0080,6 

Calculation of the fourth value involves a code of 1 16 for the source mode and a four-bit 
shift (multiplication by 10i6). The value is 

li6 * 10i6 =0010i6 
Finally, the source register number, 1 16. is unshifted. The value to be added is 0001 ,6. ^ 



^ 
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To calculate the required sum, the values are added: 



op code of MOV instruction 
Destination mode 


COOO 
OCOO 


Destination register 
Source mode 


0080 
0010 


Source register 
Patch value 


0001 
CC91 



The sum, CC91j^, is the object code to be patched. The patch value is the same as the 
value obtained in the previous example. 

When the same instruction format is used repeatedly, the multiplication constants - 400i6, 
40 16 and lOj^ - do not change and become simple to handle with practice. 

9.7.3.3 Symbolic Versus Indexed Addressing. The address mode for both symbolic (actual 
memory address) and register indexed addressing is the same (mode IO2). The type of addressing 
is determined by the register field. A register field of zero is symbolic; therefore, no RO indexing 

1 exists. In constructing a patch with a specific address, process it exactly as if it were a register 

indexed with a register of zero. Refer to the Model 990 Computer TMS9900 Microprocessor 
Assembly Language Programmer's Guide, Manual No. 943441-9701, for further information 
about symbolic and indexed memory addressing. 

9.7.3.4 Branch Distance Calculations for Jump Instructions. The signed displacement in an 
Unconditional Jump (JMP) instruction is a two's complement eight-bit number which represents 
the number of words to skip forward or backward from the current PC (the PC points to the 
instruction following the jump instruction). 

To calculate the displacement for a jump instruction, evaluate 

1/2 (target location-(instruction address+2)). 

If the target address is less than the mstruction address, add lOOOOj^ to the taiget address and 
perform the subtraction. Note that a forward branch must generate a positive displacement and a 
backward branch must generate a negative displacement to be in range. 



Example 1: 

Patch location 17Ai6 with a jump to location IFEi^. 

The source address is equal to the instruction address +2, which is 17A+2 = 17C. 

The target location minus the source address is IFE - 17C = 82. Continuing, 

1/2 (target location - source address) = 41 

The displacement, 41, is positive. The patch value is therefore 1041 1^, where 10 is the 
hexadecimal op code for the JMP instruction and 41 is the displacement value. 

Example 2: 

Patch Location IFEj^ with a jump to location 17A,6. 
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The source address is equal to the instruction address+2, which is lFEi6+2i6 = IOOk,. The 

sum of the target location plus lOOOOi^, minus the source address, is lOlTAi^ -200,6 = ^^ 

FF7A,6. Continuing ' 

1/2 (target location - source address) = 7FBD = BD (dropping the first two digits) 

The displacement, BD, is negative. The patch value is therefore lOBDi^, where 10 is the 
hexadecimal op code for the JMP instruction and BD,^ is the displacement value, negative 
in this case. 

Note that the 7F is generated from the addition of 2,6 (10000,6) and may be discarded. If 
the high order eight bits of the destination are not equal to 7F, the branch distance is too 
great to reach with a JMP instruction. 

9.7.3.5 Use of Spin and No-operation. It is sometimes convenient to patch a spin (branch to itselQ 
into a location to intercept control in unexpected situations (the alternate path of a conditional 
jump, for example). That instruction is a JMP to itself and is a value of IOFF16. (The corresponding 
assembly language code is JMP $.) 



Unwanted instructions can be replaced with a No-Operation (NOP) which is a JMP to the next 
instruction. The value for an NOP is 1000,6- Strings of NOPs may also be placed at various loca- 
tions in the program source to reserve space for temporary debug patches. 

9.7.3.6 Out-of-Line Patches. It is often necessary to patch more instructions into a program than 
there is room, requiring an out-of-line patch. The simplest mechanism is to use a symboHc address 
branch instruction to a specific location where the patch is placed. After the patch, use a branch 
instruction back to the original code. 

Example : 



^ 



^ 



0460 
(loc A)^ 
B 

0460 

(loc B) '^ 

Be careful to see that code which is overlayed is moved to the patch area, that it is not a PC 
relative jump, and that the return pointer comes to the beginning of an instruction. 



y^S^^^ 
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9.8 ERROR MESSAGES 

TXDBUG may issue any of the following error messages: 



/^^ 



/^#*\^ 



Message 

MXOl 

MX06 

MSOl 

MS05 

MPOO 

DPOO 

DP03 

DP04 

DPIO 

DPI 2 

DP13 

DP20 

DP23 

DP26 



Meaning 
Unrecoverable I/O error 
Invalid memory address or instruction 
Invalid command 
Required parameter missing 
Parameter specification error 
Invalid hexadecimal number input 
Parameter value is greater than the allowed maximum 
Snapshot is already defined 
Invalid trace region index 
CRU bit width parameter invahd 
Invalid range of registers or memory addresses 
Breakpoint specification error 
Syntax error in trace format character string 
InvaUd trace format index number 






In addition, during the initial TXDBUG load, the TX990 program loader may issue the following 
error messages: 

Meaning 

Load bias error 

Get common error (system error) 



LDFE 
LDFF 
LDXX 



All other load errors are of the form (LD(XX) where XX is 
the TXDS I/O error code received 



r^ 
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SECTION X 

TXDS PROM (TXPROM) PROGRAMMER UTILITY PROGRAM 

10.1 INTRODUCTION 

This section describes the TXPROM programmer utility program along with the required hardware 
and software . In addition, it describes the function and use of control files, bit string mapping of 
PROMs, and examples of the use of the utiHty, as well as instructions for loading and operating 
the utility. For standard operations, refer to the loading and operating procedures contained in 
paragraphs 10.4 and 10.5, plus the description of standard control files found in paragraph 10.7. | 
The description portion of this section is also helpful for operation of the utility. For custom 
mapped PROMs or PROMs with nonstandard data configurations, read all the information 
contained in this section. For further information regarding PROM programming with a 990 
Computer System, refer to the following related publications: 

Title Part Number 

Model 990 Computer TMS9900 Microprocessor 943441-9701 

Assembly Language Programmer's Guide 

Model 990 Computer PROM Programming Module 945258-9701 

Installation and Operation 

Model 990 Computer AMPL Microprocessor 946244-9701 

Prototyping Laboratory Operation Guide 

10.2 REQUIRED CONFIGURATION 

The TXPROM programmer utility program requires the following configuration for proper opera- 
tion: 

• An FS990 System 

© A Model 990 PROM Programming Unit. 

The TXPROM programmer utility software is part of the TX990/TXDS system software and is 
packaged on a diskette. TXPROM includes the following files: 

• :TXPROM/ ~ contains the PROM programming software. 

• A set of standard control files - :S288, :S287, :S471, :S472, :E2704B, :E2704,:E2708B 
:E2708, :E2716B and :E2716. ' | 

10.3 DESCRIPTION 

The TXPROM programmer utility is a software module that controls a computer hardware system 
to create custom Read Only Memories (ROMs). The hardware system can program either Program- 
mable Read Only Memory devices (PROMs) or Erasable Programmable Read Only Memory devices 
(EPROMs). Throughout this section, the term PROM refers to either of these devices unless it 
specifically excludes one of them. TXPROM is part of the Terminal Executive Development System 
that runs under the TX990 Operating System. 
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Functions performed by TXPROM include: 

• Copying data from a file to a PROM 

• Storing data from a PROM into memory or a file 

• Displaying a disc file in PROM format 

• Comparing data contained in a PROM with that contained in a file, and indicating any 
discrepancies. 

TXPROM uses predefined control information to store data in or read data from PROM devices. 
Included with the utility is a set of standard control files that contain the control information for 
reading and programming PROMs that employ the memory configuration used in the 990 Computer 
Family. For other applications, the user can modify these control files or create new files using the 
information supplied in this section. 

10.3.1 PROM BURN AND VERIFY. Three steps are required to transfer data from a data file into 
a PROM. As illustrated in figure 10-1, these steps are: 

1) Load control and data information from a diskette into separate areas in computer 
memory. 

2) Use the information contained in the control area of memory to direct the transfer of 
data to the PROM to burn-in the data. 

3) Use the information in the control area of memory to read the contents of the newly 
programmed ROM and compare the contents of the ROM with the contents of the data 
in the memory buffer area in memory. 

The TXPROM software performs the second and third steps after having been instructed to do so 
by the operator. The user must, therefore, adequately prepare both the data file and the control 
file to ensure that TXPROM accurately transfers the data to the PROM. The requirements of each 
of these files are explained later in this section of the manual. 

10.3.2 PROM READ OPERATION. A PROM read operation requires TXPROM to perform two 
steps, as illustrated in figure 10-2: 

1) Use the information contained in a control file to read data from a ROM and store the 
data in the memory buffer area. 

2) Store the information from the memory buffer area into a diskette data file as directed 
by the user. 



^ 



^ 



^ 



-^ 



^ 
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Figure 10-1. PROM Bum, Compare Operation 
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Figure 10-2. PROM Bum, Compare and Read Operation 
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The transfer of data from the memory buffer to the data file is performed on a word-for-word basis 
in binary-object format. The previous contents of the data file are lost. The data from the PROM ^"^ 

can be read into memory without being stored in an output file by specifying "DUMY" as the out- 
put file. This method can be used for preUminary inspection of ROM data, as well as for data file 
formatting. For example, to read data from four 4 X 256 PROMs and store it in a 256-word file, the 
following steps could be used: 

ft 

1) Read the first three half-bytes (4-bit transfers) into the memory buffer using a read 
operation with DUMY as the output file. This stores the first twelve bits in memory. 

2) Read the fourth half-byte into the memory buffer with a read operation that specifies 
the desired output file. The complete 16-bit word is transfeixed to the output file. 

10.3.3 LUNGS USED. TXPROM assigns LUNO AAie to the control file (see paragraph 10.5). 

10.4 LOADING TXPROM 

TXPROM is loaded under direction of the TXDS control program. Before loading TXPROM, the 
diskette containing the software must be inserted into a drive unit and that unit prepared for 
operation. Since the control program searches all system drives for the requested file, the diskette 
need not be loaded on a specific drive in multiple drive systems. When initiated, the control 
program produces the following prompt on the system console: 

PROGRAM: 

To load TXPROM, respond to this prompt as follows: 

PROGRAM: :TXPROM/*<carriage return> 

The control program then locates the file containing TXPROM, loads it into memory, and begins 
execution of TXPROM. Input and output operations will then be directed to the system console 
during execution of TXPROM. Any other interactive device supported by TXDS may be used. To 
specify a different device for interaction with TXPROM, respond to the PROGRAM: prompt as 
follows: 



^m^ 



./-■^w^ 



/<«% 



PROGRAM: :TXPROM/* [device] *<carriage return> 

10.5 TXPROM OPERATION 

When TXPROM is successfully loaded, it prints the following identification and prompt on the 
selected interactive device: 

TXPROM PROM PROGRAMMER UTILITY 937569 *A 
CONTROL FILE = 

The response to this prompt determines which of three modes of operation that TXPROM will 
enter: control file creation, control file modification, or control file execution. The following 
paragraphs describe the three modes of operation, provide a general procedure for performing each 

function, and illustrate each mode with an example. 

> 

10.5.1 CONTROL FILE CREATION. The control file creation mode allows the user to create a 

new control file for a custom application after determining that none of the standard control files 

satisfies the requirements. The mode is entered by pressing the carriage return key in response to 

the CONTROL FILE = prompt. In this mode, TXPROM outputs each control file parameter ^,„^^,^^^^^ 

prompt in order, followed by an asterisk (*). The asterisk indicates that the parameter is a variable ^ 

that must be supplied when the control file is executed. If the parameter is to remain a variable. 
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J^K 



n 



r^ 



press the carriage return key on the terminal to move to the next parameter prompt. If the 
parameter is to be a predetermined value, type that value and press the carriage return key. The 
entered value becomes the default value for that parameter. Entered values must be in decimal 
unless specified otherwise by one of the following prefixes: 



< binary 

! octal 

> hexadecimal 

For example, to enter an octal loop count of 4008 » the prompt and response appear as: 

MEM LEV 1 LOOP CNT* !400 

At any point the remaining parameter prompts may be bypassed, leaving them as variable 
parameters, by pressing the A (caret) key. TXPROM then proceeds with the file creation mode 
termination sequence. This sequence is entered either by pressing the caret key or by completing 
consideration of all parameter prompts. TXPROM then produces the prompt: 

SAVE UNDER FILE NAME = 

Entering a floppy disc file name in response to this prompt and then pressing the carriage return 
causes TXPROM to create a control file with the specified name. That file name can than be used to 
call the newly created control file for execution. Standard control files are write-protected and can- 
not be altered. Therefore, choose a file name other than a standard control file name for newly 
created or modified files. Entering only a carriage return in response to the above prompt creates no 
new file. The parameters remain in memory until modified, a control file name other than DUMY is 
specified, or TXPROM is terminated. The parameters can be accessed by referencing DUMY as the 
desired control file for execution or modification. 

When the new file name is determined and the carriage return is entered, TXPROM issues the 
following prompt: 

EXECUTE, BEGIN OR TERMINATE 

The responses to this prompt are as follows (letters in parentheses are optional): 

EX(ECUTE) Switch to execution mode and use the newly entered control file param- 

( eters for the operation. 

BE(GIN) Restart the TXPROM sequence by returning to the CONTROL FILE = 

prompt. 

TE(RMINATE) Return to the TXDS control program. 

10.5.2 CONTROL FILE MODIFICATION. The control file modification mode allows the user to 
modify the contents of a previously created control file. The mode is entered by responding to the 
CONTROL FILE = prompt with the name of an existing control file without including a parameter 
list. TXPROM then responds with the prompt: 



MODIFY OR EXECUTE? 
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Entering the following response places TXPROM in the modification mode (letters in parentheses 
are optional): 

MO(DIFY) 

TXPROM then produces the parameter prompts for the control file information as it does in 
control file creation mode, except that the prompts are followed by the existing values for the 
parameters. Asterisks indicate variable parameters that must be defined at execution time. The 
parameters can be changed by typing in the desired value in place of the existing value following 
each prompt and then pressing a carriage return. The resulting modified control file can replace 
the original file (if the original file is not a standard control file), can be saved in a new control 
file, or can be saved in memory only for immediate execution depending upon the response to the 
SAVE UNDER FILE NAME = prompt. As in the creation mode, pressing the A (caret) key at any 
time skips over the remaining parameters without changing their values. When the SAVE UNDER 
FILE NAME = prompt has been satisfied and a carriage return entered, TXPROM again produces 
the following prompt: 

EXECUTE, BEGIN OR TERMINATE 

Responses to this prompt are identical to those for creation mode. 



control data file 
file 




■^ 



^ 



10.5.3 CONTROL FILE EXECUTION. The control file execution mode allows the user to program 
a PROM using the parameters in an existing control file. The control file may be one of the supplied 
standard control files, or a custom generated file produced using the file creation mode of 
TXPROM. The execution mode is entered by responding to the CONTROL FILE = prompt with 
the name of an existing control file, or by responding with the name of an existing control file and 
its parameter list. If only a control file name is specified (without the parameter list), TXPROM 
responds with the prompt: ^'^^ 

MODIFY OR EXECUTE? 

Entering the following response places TXPROM in the execute mode (letters in parentheses are 
optional): 

EX(ECUTE) 

A parameter list is not required because TXPROM generates prompts for all missing parameters. 
However, if parameters are included, tRey must be in the order specified in table 10-1. The param- ^ 

eter list contains a string of values separated by commas and enclosed in parentheses following the 
file name. For example, the following reply to the CONTROL FILE = prompt illustrates the param- 
eter list: 



DSC:S287(DSC2:DATA, 2, 0, 0, 4, 16)<cr> 



^ 
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Table 10-1. Table of Control Ffle Parameter Prompts 



Parameter Prompt 
DATA FILE = 
DATA BIAS = 

TSFRCODE = 

CMPR AFTER = 

MEMDISP = 
PROM DISP = 

MEM START ADDR = 

# MEM BYTES = 
MEM START BIT = 
PROM START ADDR = 

# PROM WORDS = 

PROM START BIT = 

**MEM MAP LEVELS = 

MEM LEV 1 BIT STEP = 

LOOP COUNT = 

2 BIT STEP = 
LOOP COUNT = 

3 BIT STEP = 
LOOP COUNT = 

**PROM MAP LEVELS = 

PROM LEVI BIT STEP = 

LOOP COUNT = 

2 BIT STEP = 
LOOP COUNT = 

3 BIT STEP = 
LOOP COUNT = 

TSFR BIT WIDTH = 

PROM BITS/WORD = 

PROG0'sORrs = 

PULSE WIDTH = 

DUTY CYCLE = 

NO. RETRIES = 

SIMULPROG'BLEBITS = 

CRU BASE = 



Possible 
Value 

TX990 Pathname 



Oto2 



0,1 

0,1 
0,1 



1 to3 

0to7FFFi6 
1 to 32,767 
to 7FFFi6 
to 32,767 

to 7FFFi6 

1 to 32,767 

1 to 3 

0to7FFFi6 
1 to 32,767 
0to7FFFi6 
1 to 32,767 

to 7FFFi6 

1 to 32,767 

1 to 8 
1 to 8 
0,1 
1 to 6 
Oto 100 
OtoFFFFie 
1 to 8 
Oto IFFEie 



Description 

Name of data file 

Value to add to relocatable code in object 
modules 

Transfer code: nothing, 1 burn PROM, 
2 read PROM 

Compare after: nothing, 1 compare PROM 
and memory 

Memory display: nothing, 1 display memory 
PROM display: nothing, 1 display PROM 

Memory bound low (address) 

Memory bytes to be transferred 

Memory beginning bit 

PROM bound low (address) 

PROM words to be transferred 

PROM beginning bit 

Number of memory mapping levels 

Number of bits skipped between loops 
Number of repetitions of loop 1 



Number of PROM mapping levels 

Number of bits skipped between loops 
Number of repetitions of loop 1 



Transfer bit string width 

Program zero's or one's 

Programming pulse width 

% of time used in program device 

Number of retries 

Number of simultaneously programmable bits 

Base CRU address for PROM interface card 



*Any value to 7FFFi6 ; however, some parameters interact with each other to create other 
limitations. See text. 
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All numeric parameters are expected to be in decimal notation, but can be in octal, binary or 
hexadecimal if preceded by the proper prefix as described in the file creation description. When ^^ 

TXPROM enters the execute mode, it scans the contents of the control file and selects the required 
variable parameters. If a variable parameter list was suppHed, the supplied values are filled into the 
control file data. If additional values are required or if no list was supphed, then TXPROM generates 
prompts for each required parameter. 

TXPROM then checks all parameters for boundary violations. If any value is out of bounds, 
TXPROM generates a prompt for that value to be changed by the user. 

When all parameters have been verified, the control file is executed. All interrupts are disabled 
during actual data transfer between PROM and memory. When execution is complete, TXPROM 
generates the following messages: 

SUCCESSFUL EXECUTION 
REPEAT, BEGIN OR TERMINATE? 



10.7 CONTROL FILES 

TXPROM uses control files to determine the pattern that data in data files will be stored in a 
PROM. The data is not necessarily transferred to the PROM as an exact image of the data file. 
Instead, the parameters of the control file allow each bit, or group of bits, of the data file to be 
mapped to a separate location in the PROM. Table 10-1 lists each of the parameters in the control 
file along with the range of values for each parameter. In the file creation phase, TXPROM produces 
control file parameter prompts for user response. No default values exist during creation mode. 
In the file modification phase of a PROM programming sequence, TXPROM allows the user to 
change the control file parameters after issuing the prompts listed in the table. The user can then 
select the default value with a carriage return or enter a new value. The default values for each 
standard control file are Hsted later in this section. The following paragraphs describe the use and 
function of each control file parameter. 

10.7.1 DATA FILE NAME. The data file name is an alphanumeric parameter that specifies the 
name of the floppy disc data file to be used during the current operation. The file name may also 
be the name of an input file from a 733 ASR cassette drive; however, the cassette cannot be used 
as an output file to store informafion from a PROM read operation because the output format is 
not cassette compatible. To indicate that no data file is to be used, enter the file name, DUMY. 
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Proper responses to this message are as follows (letters in parentheses are optional): 

RE(PEAT) Repeat the execution process (for burning more than one PROM) 

BE(GIN) Return to the CONTROL FILE = prompt at the start of TXPROM 

TE(RMINATE) Return to the TXDS Control program. 

10.6 DATA FILES 

TXPROM uses data files to store formatted data on diskette or in computer memory. The data is in 
object format as described in the Assembly Language Programmer's Guide. The data in the files may ""^^ 

be burned into a PROM or compared to the data already in a PROM. Data files are created either by 
an assembly, by the link editor, or by reading a PROM and storing the contents in a file. When the 
data is transferred from the file to a PROM, the data is treated as a series of ascending addressed 
locafions each 16 bits long. Each 16-bit word is selected from the file according to control param- 
eters in the control file (Memory Starting Address Number of Memory Bytes, Memory Start Bit, 
Memory Level n Bit Step, and Memory n Level Loop Count). The data may then be transferred to 
the PROM according to other control file parameters so that each bit in the data file can be stored 
separately in the PROM. 
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This specification allows information to be read from a PROM into memory without being stored 
/^^^ in a data file. During the initiation sequence, TXPROM allows the user to enter the data file name 

after it issues the following prompt: 

DATA FILE = 

No default value exists for this parameter in the standard control files. 

10.7.2 DATA BIAS. The data bias parameter allows a pre-existing object module to be loaded into 
memory at a simulated load point that is displaced (biased) from the normal load point of zero. 
The actual load point in memory of the file is unaffected by this parameter. Typically, the data 
bias is the same as the base address of the data in the target system in which the PROM is to be 
used. The value of the data bias is added to each word that is marked as relocatable by the 
assembler or link editor. TXPROM accesses the data as if it were loaded in memory, starting at the 
data bias value. Therefore, the memory starting address parameter must be consistent with the ad- 
dressing used in the biased file. For example, a program that is lOOOje bytes long and is loaded 
with a data bias of SOOi^ must have its memory starting address parameter within the range of 

^ 5OO16 to 14FFi6. TXPROM allows the user to enter the data bias after it issues the following 

prompt: 

DATA BIAS = 

The default value for this parameter in the standard control files is zero (no displacement). 

10.7.3 TRANSFER CODE. The transfer code parameter defines the operation to be performed with 
the PROM device. The code is one of the following three values: 

No operation 

1 Transfer data from specified data file to PROM 

2 Read data from PROM and store in specified data file 

TXPROM allows the user to enter the transfer code parameter after it issues the following prompt: 
TSFR CODE = 

The default value for this parameter in control files :E2704B, :E2708B, and :E2716B is 1 (PROM 
bum operation). There is no default value for the other standard control files. 

10.7.4 COMPARE AFTER. The compare after parameter allows the user to enable ( 1 ) or disable (0) 
a comparison of the PROM data with the data file data following either a bum or a read operation. 
If the comparison is successful, TXPROM proceeds to the next operation. If the comparison fails, 
TXPROM displays the memory byte address, the PROM address, and the two bit strings in the 
following format: 

>Mxxxx.yy=zz Raaaa.bb=cc 

Refer to the description of memory display and PROM display later in this section for an explana- 
tion of the display formats. TXPROM allows the user to enter the compare after parameter after 
it issues the following prompt: 

CMPR AFTER = 



n 



/B^^ 



^ 
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The default value for this parameter in control files :E2704B, :E2708B, and :E2716B is (disable 
comparison). There is no default value for the other standard control files. 

10.7.5 MEMORY DISPLAY. The memory display parameter allows the user to select a display of 
the memory data file on the data terminal being used. This parameter may be either a 1 to enable 
memory display, or a to inhibit memory display. If the memory display parameter is equal to a 1, 
the memory region containing the data file is displayed in the following format: 

Mxxxx. yy=zz 

In this notation, the letters have the following significance: 

M = Designates a memory display 

xxxx = Memory byte address 

yy = Displacement of start of bit string within memory byte (0<yy<7) 

zz = The value of the bit string in hexadecimal notation when right-justified within 
an 8-bit field. 

A maximum of four entries are displayed on each output Une of the terminal. For example, a 
memory display value of: 

MOOOB. 00=5A 

indicates that the bit string at byte address GGOBie that begins with the first bit of that byte has a 

value of 5Ai6. TXPROM allows the user to enter the memory display parameter after it issues the ^'^ 

following prompt: 

MEM DISP = 

The default value for this parameter in the standard control files is zero (no display). 

10.7.6 PROM DISPLAY. The PROM display parameter allows the user to select a display of the 
PROM contents being burned or read. The display appears on the data terminal being used to 
initiate TXPROM during the execution of the program. This parameter may be either a 1 to enable 

PROM display, or a to inhibit PROM display. If the PROM display parameter is equal to a 1 , the ^ 

PROM region is displayed in the following format: 

Raaaa. bb=cc 

In this notation, the letters have the following significance: 

R = Designates a ROM or PROM display 

aaaa = PROM/ROM word address 

bb = Displacement of start of bit string within PROM word (0<bb<7) 

cc = The value of the bit string in hexadecimal notation when right-justified within an 
8-bit field. 



x.«WK 
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A maximum of four entries are displayed on each output line of the terminal. For example, a 
PROM display of 

ROOE 1.00=7 A 

indicates that the bit string at PROM word address OOEl j^ , that begins the first bit of that byte, has 
a value of 7Ai6 . TXPROM allows the user to enter the PROM display parameter after it issues the 
following prompt: 

PROM DISP = 

The default value for this parameter in the standard control files is zero (no display). 

10.7.7 MEMORY STARTING ADDRESS. The memory starting address parameter indicates the 
starting address in memory of the first bit string to be transferred to the PROM or to be read from 
the PROM. If the object module is relocatable, the memory starting address is an absolute memory 
address. TXPROM allows the user to change the memory starting address parameter by producing 
the following prompt: 

MEM START ADDR = 

No default value exists for this parameter in the standard control files. 

10.7.8 NUMBER OF MEMORY BYTES. This parameter indicates the number of bytes to be 
transferred from or to memory during the PROM operation. TXPROM adds this value to the 
memory starting address to create a range of addresses in memory for the transfer operation. If 
TXPROM tries to access a bit string outside this range of addresses, an error is indicated. TXPROM 
allows the user to change the memory bytes parameter by producing the following prompt: 

# MEM BYTES = 

The default value for this parameter varies with the particular standard control file. 

10.7.9 MEMORY STARTING BIT. This parameter indicates the starting bit address relative to the 
starting byte (indicated by memory starting address) of the bit string to be transferred during the 
operation. The value of this parameter may be any positive magnitude; however, if the value 
exceeds 7, the starting bit will be located beyond the starting byte indicated by the memory starting 
address. TXPROM allows the user to enter the memory starting bit after it issues the following 
prompt: 

MEM START BIT = 

No default value exists for this parameter in the standard control files. 

10.7.10 PROM STARTING ADDRESS. The PROM starting address parameter indicates the 
starting word address in PROM of the first bit string to be burned or to be read. TXPROM 
allows the user to enter the PROM starting address after it issues the following prompt: 

PROM START ADDR = 

The default value for this parameter in the standard control files if 0. 
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10.7.1 1 NUMBER OF PROM WORDS. This parameter indicates the number of PROM words that 

will be processed during the current operation. TXPROM adds this value to the PROM starting -'^^ 

address to create a range of addresses in PROM for the transfer operation. If TXPROM tries to 
access a bit string outside this range of addresses, an error is indicated. TXPROM allows the user to 
enter the PROM words parameter after it issues the following prompt: 

# PROM WORDS = 

The default value for this parameter varies with the particular standard control file. 

10.7.12 PROM STARTING BIT. This parameter indicates the starting bit address relative to the 
starting word address (indicated by PROM starting address) of the bit string to be processed. The 
value of this parameter may be any positive magnitude; however, if the value exceeds the word size 
for the PROM device type being used, the starting bit is located beyond the starting word indicated 
by the PROM starting address. TXPROM allows the user to enter the PROM starting bit after it 
issues the following prompt: 



PROM START BIT = 

The default value for this parameter in the standard control files is 0. 

10.7.13 MEMORY MAPPING LEVELS. The memory mapping levels parameter specifies the 
number of loop levels to be used in mapping data from memory into the PROM device. The number 
of levels may be 1, 2 or 3. Refer to the discussion of Bit String Mapping later in this section for 
complete information about the use of this parameter. If this parameter is 1 , then the loop count 
for levels 2 and 3 are automatically set to 1. TXPROM allows the user to enter the memory 
mapping levels parameter after it issues the following prompt: 

**MEM MAP LEVELS = 

Enter a value of 1 for all standard control files except :E2704B, :E2708B, and :E2716B. For these 
files, enter a value of 2. 

10.7.14 MEMORY LEVEL n BIT STEP. This parameter determines the number of bits that are 
skipped between successive bit addresses when performing a level n (n = 1, 2, or 3) mapping loop. 
For example, to access only the even-numbered bits (or the odd-number bits) this parameter is set 
to a value of 1. This value causes a skip of one bit between each bit accessed. TXPROM allows the 
user to enter this parameter for each of the three possible mapping levels after it issues the following 
prompt(s) (only the prompts for the number of levels selected in the memory mapping levels 
parameter are produced): 

MEM LEV 1 BIT STEP = 

or 
MEM LEV 2 BIT STEP = 

or 
MEM LEV 3 BIT STEP = 






^'^^^. 
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The default value for the level 2 and 3 parameters in the standard control files is zero. There is no 
default value for the level 1 parameter in the standard control files. 

10.7.15 MEMORY LEVEL n LOOP COUNT. This parameter determines the number of iterations 
that are performed of the level n (n=l , 2 or 3) mapping loop. The value may be within the range of 
to FFFF16. TXPROM allows the user to enter this parameter for each of the three possible 
mapping levels after it issues the following prompts (only the prompts for the number of levels 
selected in the memory mapping levels parameter are produced; all other levels are set to one: 

MEM LEV 1 LOOP COUNT = 

or 
MEM LEV 2 LOOP COUNT = 

or 

MEM LEV 3 LOOP COUNT = 

The default value for each of these parameters in the standard control files varies with the selected 
control file. 

10.7.16 PROM MAPPING LEVELS. The PROM mapping levels parameter specifies the number of 
loop levels to be used when mapping data into the PROM. The number of levels may be 1, 2 or 3. 
Refer to the discussion of Bit String Mapping later in this section for complete information about 
the use of this parameter. If this parameter is 1 , then the loop count for levels 2 and 3 are automa- 
tically set to 1 . TXPROM allows the user to enter the PROM mapping levels parameter after it issues 

/^^ the following prompt: 

**PROM MAP LEVELS = 

When responding to this prompt, enter a value of 1 for each standard control file except :E2704B, 
:E2708B, and :E2716B. These files require a response of 2. 

10.7.17 PROM LEVEL n BIT STEP. This parameter determines the number of bits that are 
skipped between successive bit addresses when performing a level n (n = 1, 2 or 3) mapping loop. 
For example, to bum every other bit in a PROM (either the odd or even bit addresses) this param- 

f^^ eter is set to a value of 1 . This value causes a skip of one bit between each bit operated on in the 

PROM. TXPROM allows the user to enter this parameter for each of the three possible mapping 
levels after it issues the following prompt(s) (only the prompts for the number of levels selected in 
the PROM mapping levels parameters are produced): 

PROM LEV 1 BIT STEP = 

or 
PROM LEV 2 BIT STEP = 

or 
PROM LEV 3 BIT STEP = 



/^^^\ 
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The default value for level 1 in the standard control file :S287 is 4; all other standard control files 
have a default value of 8. 

The default value for levels 2 and 3 for this parameter in the standard control files is zero. This 
value causes TXPROM to access every consecutive bit in the PROM. 

10.7.18 PROM LEVEL n LOOP COUNT. This parameter determines the number of iterations 
that are performed of the level n (n = 1 , 2, or 3) mapping loop. The value may be any number from 
1 to 32767. TXPROM allows the user to enter this parameter for each of the three possible PROM 
mapping levels after it issues the following prompt(s) (only the prompts for the number of levels 
selected in the PROM mapping levels parameter are produced; all other levels are set to one): 

PROM LEV 1 LOOP COUNT = 

or 
PROM LEV 2 LOOP COUNT = 

or 

PROM LEV 3 LOOP COUNT = 

The default value for each of these parameters in the standard control files varies with the selected 
control file. 

10.7.19 TRANSFER BIT WIDTH. The transfer bit width designates the number of bits that are to 
be transferred in each bit string. This parameter appHes to both the memory and the PROM 
portions of the operation. TXPROM allows the user to change the transfer bit width by producing ^"^ 
the following prompt: 

TSFR BIT WIDTH = 

The default value for this parameter in standard control file :S287 is 4; all other standard control 
files have a default value of 8. 

10.7.20 PROM BITS PER WORD. This parameter specifies the number of bits in each word of the 
PROM device being used. It should match the architecture of the PROM device. TXPROM allows 

the user to change this parameter by producing the following prompt: ? 

PROM BITS/WORD = 

The default value for this parameter in standard control file :S287 is 4; all other standard control 
files have a default value of 8. 

10.7.21 PROGRAM ZEROS OR ONES. This parameter indicates whether the PROM device begins 
as all zeros and must be programmed by burning ones, or if it begins as all ones and must be 
programmed by burning zeros. The PROM Programmer Installation and Operation Manual contains 
a table of initial conditions for all devices that can be programmed with that unit. This parameter 
should be set to a 1 if a high-level programming pulse (programmed with ones) is required, and to a 
if a low-level programming pulse (programmed with zeros) is required. TXPROM allows the user 
to change this parameter by producing the following prompt: 

PROGO'soR rs= '^ 
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The default value for this parameter in the standard control files varies with the control file 
selected. 

10.7.22 PULSE WIDTH. The pulse width parameter is a code that designates the duration of the 
programming pulse to be used with the selected PROM device. Table 10-2 Usts and defines these 
codes. Table 10-3 lists the programming pulses required for some commonly used PROM devices. 
The pulse width is the length of time that power is appUed to the PROM device to bum 
simultaneously programmable bits. TXPROM allows the user to change the value of this parameter 
by producing the following prompt: 

PULSE WIDTH = 

The default value for this parameter in the standard control files varies with the control file 
selected. 

Table 10-2. Pulse Widths 



j^^ 



Pulse Width 
Code 



Pulse Width 
(ms) 



1 
2 
3 
4 
5 
6 



0.5 
1.0 
2.0 
4.0 
8.0 
16.0 



Pulse Width=2*=°^^*(.25)ms 



Table 10-3. Minimum, Standard and Maximum Pulse Widths and Duty Cycles 



PROM Types 



Pulse Width (ms) Duty Cycle 

Minimum Standard Maximum Minimum Standard 



Maximum 



TIL 



188A, 5188,8288, 
8287,5387,8470, 
8471,5472,5473 



20 



25% 



35% 



EPROMs 



2704,2708,2716 



0.1 



0.1 



50% 



50% 



/J#^V. 



Note: TTL PROM types have the prefix SN74. 
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10.7.23 DUTY CYCLE. The duty cycle parameter indicates the percentage of the programming 
cycle time that it actually used for burning the PROM. The total programming cycle consists of a 
programming (burn) phase and a rest phase. The duty cycle value (between and 100) represents ^^^ 
the maximum percentage of total time that the programming pulse can be active. Table 10-3 lists 

the duty cycle requirements of some commonly used PROM devices. TXPROM allows the user to 
change this parameter to match the requirements of the PROM device being used by producing the 
following prompt: 

DUTY CYCLE = 

The default value for this parameter in the standard control files is 25 for PROMs and 50 for 
EPROMs. 

10.7.24 NUMBER OF RETRIES. This parameter indicates the number of times that TXPROM 
will try to program a specific set of bits without success using the normal pulse width. If the first 
attempt to program a set of bits in a PROM device fails. TXPROM repeats the programming cycle 
for that set of bits until the correct data is transferred or the number of retries count is depleted. 
TXPROM allows the user to change this parameter by producing the following prompt: 

NO. RETRIES = 

The default value for this parameter in the standard control files is zero. 

10.7.25 SIMULTANEOUSLY PROGRAMMABLE BITS. This parameter indicates the number of 
bits in the PROM device that can be programmed with the same programming pulse. This parameter 
is a physical restriction of the type of PROM device. Bipolar devices require that only one bit be 
programmed at a time; EPROMs require that an entire EPROM word be programmed simultan- 
eously. TXPROM allows the user to change this parameter by producing the prompt: ^<«^ 

SIMUL PROG'BLE BITS = 

The default value for this parameter in the standard control files is 1 for PROMs and 8 for EPROMs. 

10.7.26 CRU BASE. The CRU base parameter of the control file defines the CRU base address to 
be used to select the PROM Programmer interface card. For standard applications, the interface 
card responds to base address 20i6 • If the interface card is installed in a chassis location other than 
the standard slot, the CRU base parameter must be changed. TXPROM allows the user to enter the 

CRU base after it issues the following prompt: "^ 

CRU BASE = 
The default value for this parameter in the standard control files is 20i6 • 

10.8 BIT STRING MAPPING 

The software uses the memory and PROM mapping parameters to determine the addresses of the bit 
strings to be used in the programming cycle. When specifying mapping parameters, the PROM or 
memory words within the defined bounds are considered to be a continuous string of bits. The 
memory file is further divided into 1 6-bit words, while the PROM string is divided into words whose 
length is determined by the architecture of the device. Mapping is required so that portions of the 
16-bit memory words may be programmed into PROMs that have smaller word widths. The 
mapping parameters include bit step and loop count, as defined previously in this section. 

TXPROM allows three levels of bit string mapping: level 1, level 2 and level 3. Level 1 determines ^-^"^ 

successive bit strings in memory or PROM. When the level 1 loop count is exhausted, the initial bit 
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is incremented as determined by the level 2 bit step and the level 1 mapping is repeated. Each 
time that the level 1 loop count is exhausted, the level 2 loop count is decremented, the initial 
bit incremented, and the mapping repeated until the level 2 loop count is exhausted. At that point, 
the level 3 increment is added to the beginning address, the level 3 loop count is decremented, the 
loop counts for levels 1 and 2 are restored, and the entire cycle is repeated. When the level 3 loop 
count is exhausted, cycUng is complete. A map cycle for memory bits is completely independent 
of a map cycle for PROM bits; however, the total number of bits that are mapped in the memory 
cycle must be equal to the number of bits mapped to a PROM. 

10.8.1 LEVEL 1 MAPPING EXAMPLE. Figure 10-3 illustrates an example of level 1 mapping. In 
the example, the first four bits of each memory word are mapped into the odd-numbered addresses 
of a 256 X 4 PROM, (a 128 half-byte transfer). Table 10-4 lists the mapping parameters for both 
memory and PROM to accompHsh the transfer. 

10.8.2 LEVEL 2 MAPPING EXAMPLE. Figure 10-4 illustrates an example of level 2 mapping. In 
the example, the first and the last four bits of each memory word are mapped into a 256 X 8 PROM 
(a 256-byte transfer). Table 10-5 lists the mapping parameters for both memory and PROM to ac- 
complish the transfer. The example combines level 2 memory looping with level 1 PROM looping. 
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Figure 10-3. Level 1 Mapping Example 
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Table 10-4. Level 1 Mapping Example Parameters 



File (Memory) Mapping Parameters 

MEM START ADDR=0 
# MEM BYTES = 256 
MEM START BIT =0 
MEM LEVI BIT STEP =16 
MEM LEV 1 LOOP CNT = 1 28 
MEM LEV 2 BIT STEP = 
MEM LEV 2 LOOP CNT =1 
MEM LEV 3 BIT STEP = 
MEM LEV 3 LOOP CNT = 1 



PROM Mapping Parameters 

PROM START ADDR = 
#PROM WORDS = 256 
PROM START BIT = 4 
PROM LEV 1 BIT STEP = 8 
PROM LEV 1 LOOP CNT = 1 28 
PROM LEV 2 BIT STEP = 
PROM LEV 2 LOOP CNT = 1 
PROM LEV 3 BIT STEP = 
PROM LEV 3 LOOP CNT = 1 



^<mm^ 



TRANSFER BIT WIDTH = 4 
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Figure 10-4. Level 2 Mapping Example 
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Table 10-5. Level 2 Mapping Example Parameters 



File ( Memory) Mapping Parameters 



PROM Mapping Parameters 



MEM START ADDR = 
#MEMBYTES = 512 
MEM START BIT = 
MEM LEVI BIT STEP =12 
MEM LEV 1 LOOP CNT = 2 
MEM LEV 2 BIT STEP =16 
MEM LEV 2 LOOP CNT = 256 
MEM LEV 3 BIT STEP = 
MEM LEV 3 LOOP CNT =1 



PROM START ADDR = 
#PROM WORDS = 256 
PROM START BIT = 
PROM LEV 1 BIT STEP = 4 
PROM LEV 1 LOOP CNT =512 
PROM LEV 2 BIT STEP = 
PROM LEV 2 LOOP CNT = 1 
PROM LEV 3 BIT STEP = 
PROM LEV 3 LOOP CNT = 1 



/plP*\^ 



TRANSFER BIT WIDTH = 4 

10.8.3 LEVEL 3 MAPPING EXAMPLE. Figure 10-5 illustrates an example of level 3 mapping. In 
the example, the first and the last four bits of each memory word are mapped into the first 256 
words of a 1024 X 8 PROM. The mapping of the memory words is then repeated three more times 
to fill the 1024 words of the PROM. Table 10-6 lists the mapping parameters for both memory and 
PROM to accomplish the transfer. 

10.9 STANDARD CONTROL FILES 

The TXPROM software includes a set of standard control files. The files contain parameters that 
can be used without modification to program most PROM devices commonly used with the PROM 
programming system. Table 10-7 lists the standard control files along with their contents. For 
special applications, these files can also be used as the basis for building a custom control file, rather 
than creating a new file. EPROM devices have two control files: the file with the letter B suffix is 
for bum cycles and the file with no suffix is for reads. EPROM devices require repeated program- 
ming cycles to implant the charge. The EPROM "B" files automatically repeat the programming 
cycle to allow for this requirement. The standard control files reside on the same diskette as the 
TXPROM software. 

10.10 VARIABLE PARAMETERS 

None, any, or all of the parameters in a control file can be made into variable parameters by 
entering a value of * for each parameter prompt when the control file is created or modified. The 
values for these parameters are not stored in the control file but must be entered in at execution 
time (whenever the control file name is requested). Variable parameters allow frequently changed 
parameters (like DATA FILE name) to be easily inserted, nonpermanently, into control file 
parameters. 

For example, the Standard Control file for 74287 bipolar TTL PROM devices was created with the 
following variable parameters: DATA FILE, TSFR CODE, CMPR AFTER, MEM START ADDR, 
MEM START BIT, MEM LEV 1 BIT STEP. To use the standard control file, the user must respond 
to the control file prompt with: 



DSC:S287(<data file>,<tsfr code>,<cmpr after>,<mem 
<niem lev 1 bit step>). 



start addr>,<mem start bit>, | 



The parameters inside the angle brackets, < >, must be supplied with the desired values. If no 
parameters are entered, TXPROM generates prompts to ask for the information. 
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Figure 10-5. Level 3 Mapping Example 
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Table 10-6. Level 3 Mapping Example Parameters 



File (Memory) Mapping Parameters 

MEM START ADDR = 
#MEM BYTES = 512 
MEM START BIT = 
MEM LEVI BIT STEP =12 
MEM LEVI L00PCNT=2 
MEM LEV 2 BIT STEP =16 
MEM LEV 2 LOOP CNT = 256 
MEM LEV 3 BIT STEP = 
MEM LEV 3 LOOP CNT = 4 



PROM Mapping Parameters 

PROM START ADDR =0 
# PROM WORDS =1024 
PROM START BIT =0 
PROM LEV 1 BIT STEP = 4 
PROM LEV 1 LOOP CNT = 1024 
PROM LEV 2 BIT STEP = 
PROM LEV 2 LOOP CNT = 1 
PROM LEV 3 BIT STEP = 
PROM LEV 3 LOOP CNT = 1 



TRANSFER BIT WIDTH = 4 

10.11 PROGRAMMING EPROMS 

Since EPROMs are metal-oxide-semiconductor (MOS) devices, they must be programmed in a 
different manner than TTL PROM devices. EPROMs are charge-storage devices that must be 
programmed by repetively transferring charge to EPROM bits. This repetition may be accomplished 
by looping through the programming process defined by the data configurations. The number of 
required repetitions to transfer sufficient change to each bit or bit string is defined by the following 
formula: 



100 ms = pulse width x repetitions. 

Therefore, using a pulse width of 0.5 ms, 200 repetitions must be used to successfully program the 
EPROM. A delay must occur after each attempt to program a bit string before trying to program 
the same bit string again. This delay allows the charge to diffuse into the EPROM device without a 
buildup of charge on the surface. 

Because of this delay, each bit string of the EPROM should be attempted once before repeating 
the programming cycle. To ensure this delay, the number of retries parameter for programming each 
bit string (defined in the control file) must be set to zero. Each bit of the EPROM will not appear 
to have the correct value (0 or 1 ) until sufficient charge has been transferred to it. 

In the early stages of programming, the bits may not have acquired sufficient charge to have the 
correct value. This appears as a programming failure if the number of retries is set to a nonzero 
value, and the bit string will be programmed again without the required delay time. For the same 
reason, the compare after parameter (defined in the control file) should not be set during the 
programming cycle, since compare errors will be found in the early stages of programming an 
EPROM. 

Since the programming cycle for an EPROM repeats many times, the display parameter (defined by 
the control file) should not be set during the programming cycle. Setting the display parameters 
prints the memory or PROM data for each repetition. Therefore, to program, compare and display, 
the process must be done in two steps. First, the parameters must be set to zero to program, and 
after completion of EPROM programming, the parameters may be set to enable compare and/or 
display. The number of repetitions defined must be changed to one before the second step in order 
to compare and/or display. 
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Table 10-7. Standard Control Files 
Standard Control FUe :S288 :S287 :S471 :S472 :E2704B :E2704 :E2708B :E2708 :E2716B £2716 



."m^ 



Data File 


* 


* 


* 


* 


* 


♦ 


* 


* 


* 


* 


Data Bias 
































TSFRCode 


* 


* 


♦ 


* 


1 


* 


1 


* 


1 


* 


CMPR After 


* 


* 


* 


^ 





* 





* 





* 


MEM Disp 
































PROM Disp 
































MEM Start Addr 


* 


* 


* 


* 


* 


* 


* 


* 


^ 


* 


# MEM Bytes 


64 


512 


512 


1024 


1024 


1024 


2048 


2048 


4096 


4096 


MEM Start Bit 


* 


* 


* 


* 


* 


* 


* 


* 


♦ 


* 


PROM Start Addr 
































#PROM Words 


32 


256 


256 


512 


512 


512 


1024 


1024 


2048 


2048 


PROM Start Bit 
































MEM Map Levels 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


t 


+ 


i 


MEM LEVI BIT STEP 


* 


* 


* 


* 


* 


* 


* 


* 


* 


* 


Loop Count 


32 


256 


256 


512 


512 


512 


1024 


1024 


2048 


2048 


MEM LEV 2 BIT STEP 
































Loop Count 


1 


1 


1 


1 


200 


1 


200 


1 


200 


1 


MEM LEV 3 BIT STEP 
































Loop Count 


1 


1 


1 


1 


1 


1 


1 


1 


1 


1 


PROM Map Levels 


+ 


+ 


+ 


t 


+ 


+ 


+ 


+ 


:t^ 


•t 


PROM LEV 1 BIT STEP 


8 


4 


8 


8 


8 


8 


8 


8 


8 


8 


Loop Count 


32 


256 


256 


512 


512 


512 


1024 


1024 


2048 


2048 


PROM LEV 2 BIT STEP 
































Loop Count 


1 


1 


1 


1 


200 


1 


200 


1 


200 


1 


PROM LEV 3 BIT STEP 
































Loop Count 


1 


1 


1 


1 


1 


1 


1 


1 


1 


1 


TSFR Bit Width 


8 


4 


8 


8 


8 


8 


8 


8 


8 


8 


PROM Bits/Words 


8 


4 


8 


8 


8 


8 


8 


8 


8 


8 


PROG Os, PROG Ts 


1 





1 


1 




















Pulse Width 


2 


2 


2 


2 


1 


1 


1 


1 


1 


1 


Duty Cycle 


25 


25 


25 


25 


50 


50 


50 


50 


50 


50 


Number Retries 
































SIMUL Prog^le Bits 


1 


1 


1 


1 


8 


8 


8 


8 


8 


8 


CRU Base 


>20 


>20 


>20 


>20 


>20 


>20 


>20 


>20 


>20 


>20 



^f^:\ 



^•^^^ 



^ 



*Indicates variable parameters; i.e., value must be entered at execution time. 

tA response is required. Enter 2 for :E27048B, :E2708B, and :E2716B. Enter 1 for all other standard control'files. 



^<-«%v 
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If level n bit string mapping is used to burn an EPROM, the level (n+l)'s bit step should be set to 
and the loop count set to the desired number of repetitions. Note that the standard control files for 
EPROM bums have level 2 loop counts of 200. 

10.12 PROGRAMMING EXAMPLES 

The following paragraphs illustrate the control file requirements to successfully program a PROM or 
EPROM using TXPROM. 

10.12.1 EPROM EXAMPLE. The following example programs an 8-word data file vertically to the 
first 16 locations of a 512 X 8 EPROM (2704) as illustrated in figure 10-6. 



(A)l 36191 



MEMORY 










1 5 





1 


2 


2 


4 


3 


6 


4 


8 


5 


10 


6 


1 2 


7 


1 4 


8 



o 



6 

7 

8 

9 

10 

1 1 

1 2 

13 
14 

1 5 



EPROM 



1 


2 


3 


4 


5 


6 


7 


8 



Figure 10-6. EPROM Programming Example 
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Bits are transferred one at a time from memory to the EPROM. The user creates a control file by 
modifying the E2704B standard control file. The following parameters are modified: 

MEM MAP LEVELS = 2 
MEM START ADDR = 

# MEM BYTES = 16 
MEM START BIT = 

MEM LEV 1 BIT STEP = 1 

LOOP COUNT = 256 
MEM LEV 2 BIT STEP = 

LOOP COUNT = 200 
PROM LEVELS = 3 
PROM START ADDR = 

# PROM WORDS =16 
PROM START BIT = 
PROM LEV 1 BIT STEP = 8 

LOOP COUNT = 16 
PROM LEV 2 BIT STEP = 1 

LOOP COUNT = 16 
PROM LEV 3 BIT STEP = 

LOOP COUNT = 200 



Burns 1 word of memory vertically 
Positions to next column 
200 repetitions since EPROM 






TRANSFER BIT WIDTH = 1 

10.12.2 PROM PROGRAMMING EXAMPLE. Twenty-four 4-bit fields are arranged in 16-bit 
words of a data file, as shown in figure 10-7. These 24 fields are to be programmed repetitively in 
the first 384 four-bit words of a 512 X 4 PROM with characteristics similar to a TI SN74S287 (two 
287s with a programming adaptor card to make them appear as a 512 X 4 device) as illustrated in 
figure 10-7. 

The user starts with the S287 standard control file and makes the following modifications: 



File (Memory) Mapping Parameters 

MEM START ADDR = 
# MEM BYTES = 16 
MEM START BIT = 
MEM MAP LEVELS = 3 
MEM LEV 1 
MEM LEV 1 
MEM LEV 2 
MEM LEV 2 
MEM LEV 3 
MEM LEV 3 



BIT STEP = 6 
LOOP COUNT = 3 
BIT STEP ^16 
LOOP COUNT = 8 
BIT STEP = 
LOOP COUNT =16 



PROM Mapping Parameters 

PROM START ADDR = 

# PROM WORDS = 384 

PROM START BIT = 

PROM LEVELS = 1 

PROM LEV 1 BIT STEP = 4 

PROM LEV 1 LOOP COUNT - 



384 



TRANSFER BIT WIDTH = 4 
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MEMORY 
ADDRESS 



BIT 
DISPLACEMENT 



1 2 



14 



1 



10 



1 1 



1 6 



19 



22 



m 



^ 



7. 



m 



1 1 



1 4 



17 



20 



23 



^. 




^ 



^ 



J 



• > 

23 ^4 J 

24 1 ^ 



REPETITION 1 



• 
• 



47 



f^- 



> REPETITION 2 



• 



(A)136192 



383 



>REPETITION 16 



Figure 10-7. PROM Programming Example 



1 5 



12 



1 5 



18 



21 



24 



MEMORY 
(FILE IMAGE) 



10.12.3 CONTROL FILE CHANGE EXAMPLE. The user wishes to change the S471 standard 
control file so that the parameter DATA BIAS is a variable parameter. The user does the following: 

CONTROL FILE = DSC:S471<cr> 
MODIFY OR EXECUTE? MO<cr> 
MODIFICATION MODE 



DATA FILE = *<cr> 
DATA BIAS = * <Acr> 



The user updates the value to "*" and uses the 
shift A to skip the remaining prompts. 



SAVE UNDER CONTROL FILE NAME=DSC:S471/MOD <cr> 
EXECUTE, BEGIN or END? END 
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The modified control file DSC:S471/MOD can now be used instead of the standard control file. 
The parameters that need be entered for its use are now: DATA FILE, DATA BIAS, TSFR CODE, 
CMPR AFTER, MEM START ADDR, MEM START BIT, MEM LEV 1 BIT STEP. 

10.12.4 EXECUTING A CONTROL FILE EXAMPLE. This example uses the control file created 

in the previous example to burn a pair of S471 ROMS (256 X 8) from a 256-word relocatable 

object module named DATA on the disc in drive 2. The ROMS eventually will be stationed at ^ 

address FOOO on a computer memory card. 

CONTROL FILE = 

DSC :S471/MOD(DSC2: DATA, FOOO, 1, 1, 0, 0, 16) 

DSC:S471/MOD(DUMY,F000, 1, 1, 0, 8, 16) 

10.13 NONRECO VERABLE ERROR MESSAGES 

The following is a list of nonrecoverable error messages issued by TXPROM. These errors cause 
abortion of all action and return to the CONTROL FILE = prompt: 

DATA FILE OPEN ERROR .«k 

DATA FILE I/O ERROR 

CONTROL FILE OPEN ERROR 

CONTROL FILE I/O ERROR 

HARDWARE MALFUNCTION 

HARDWARE OFFLINE 

NO. STRING COUNT ERROR 

STRING ADDRESS OUT OF BOUNDS 

CAN'T GET MEMORY 



/^^\ 



Change 1 10-26 Digital Systems Division 




946258-9701 



^ 



SECTION XI 
TXDS BNPF AND HIGH-LOW (BNPFHL) DUMP UTILITY PROGRAM 



/ip^N 



11.1 INTRODUCTION 

The BNPFHL utility program provides the capability of converting a 990 Computer module in 
standard object code format (i.e., in compressed or noncompressed format) to a module in BNPF 
format (figures 1 1-1 and 1 1-2) or to a module in High-Low format. The conversion from standard 
object code format to BNPF format is presented in figure 11-1. 



O Q Q 

O 0^ O Q^ CD IK 

coos^cSoo&bSooo^ 



STANDARD OBJECT CODE FORMAT 




BNNNNNNNNF BNNPP'PNN 



(A)136193 



F BNNNNNNNNF"^-BNPF FORMAT 



Figure 11-1. Standard Object Code Format to BNPF Format Conversion 



BYTE-LENGTH OF STANDARD OBJECT CODE (FULL FIRST LINE) 

INPUT FILE 

05058LIGHTS AO000C0038C0OO6a0000BO200BFFFFB06AOC0022BO9 10B17FC7F I EAF LIGHOOOl 

O CORRESPONDING 
»- DATA 



eflNNr^NNNNF BNNPPPNNNF BNNNNNNNNF BNNNNNPPNF BNNNNNNNNF BNNNNNNNNF 
k ^ ST— ^ 

V 



FIRST BYTE 



BNPF FORMAT (FULL FIRST LINE) 



DECIMAL BYTE ADDRESS 
OF FIRST BYTE 
(ASSUMING ZERO BIAS) 
(A )1 36 194 



Figure 11-2. Standard Object Code Format to BNPF Format, Full First Line Conversion 
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y^-SSffilj^ 



C0038C0006B0000 < STANDARD OBJECT CODE FORMAT 

LLLL LLLL LLLL^ — HIGH-LOW FORMAT 
(A)136195 



Figure 11-3. Standard Object Code Format to High-Low Format Conversion 



00058LIGHTS A0000C0038C0006B0000B0200BFFFFB06A0C0022B09 10B17FC7F1EAF LIGHOOOl 



./flS^Jfty 



i i 



LJ 



{CORRESPONDING 
DATA 



000r007;LLLL''LLLL''LLLL^LLLL HHHH LLLL LLLL LLLL 

HIGH-LOW FORMAT (FULL FIRST LINE) 
^ADDRESS OF LAST FOUR-BIT STRING 
ADDRESS OF FIRST FOUR-BIT STRING 
(A)136196 




^ 



Figure 114. Standard Object Code Format to High-Low Format, Full First Line Conversion 



^ 



When a module in standard object code format is converted to BNPF format, each byte of the 
standard object code is converted into a string of Ns and Ps (as shown above) preceded by a B 
(denoting the beginning of the byte) and followed by an F (denoting the end or finish of the byte). 
Each N corresponds to a negative or zero bit value and each P corresponds to a positive or one bit 
value. The output module in the BNPF format begins with the decimal byte address (up to five 
digits) of the first byte contained on the line (as presented in figure 11-2). This decimal byte 
address has no leading zeros and begins in column one. Each of the lines in the BNPF formatted 
module contains no more than six bytes of information. An example of a full first line of standard 
object code is presented in figure 11-2 with the full first line of a converted module in BNPF 
format. The numbers being converted in figure 11-2 are identical to those shown in figure 11-1. 

The conversion from standard object code format to High-Low format is presented in figure 11-3. 
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When a module in standard object code format is converted to High-Low format, one of the four 
hexadecimal numbers in each word of the standard object code is converted into a four-bit string 
of Hs and Ls (where each H corresponds to a high or one-bit value and each L corresponds to a low 
or zero bit value). The hexadecimal number in each word to be converted is selected by use of the 
Position option entry. (Refer to paragraph 11.3.3.5 for a description of the Position option entry 
function.) This Position option entry may be used to specify a 0, 4, 8, or 12, respectively, for the 
first, second, third, or fourth hexadecimal numbers in the word. The conversion of the hexadecimal 
number in the first word, into a four-bit string of Hs and Ls, is followed by a conversion of the 
corresponding hexadecimal number in the same position of the second word (of the standard object 
code). The process is continued for each corresponding hexadecimal number in each of the words 
specified in the response to the MEMORY: prompt. (Refer to paragraph 1 1.3.4 below for a descrip- 
tion of the response to the MEMORY: prompt). The Position option entry may also be used to 
enter any one of the numbers from through 12 and thereby, specify the bit position in the 16-bit 
word at which the four-bit conversion is to begin. This means, for example, that specifying a 3 
would result in converting bits 3, 4, 5, and 6 of the 16-bit word (which is represented in hexa- 
decimal standard object code format) to a four-string of Hs and Ls. The output module in the High- 
Low format begins each line with the beginning and end address (in decimal) of each of the four- 
bit strings presented on the line, using three digits for the address of the first four-bit string on the 
line and another three digits for the address of the last four-bit string on the line. (See figure 1 1-4.) 
Each of the lines contains no more than eight four-bit strings. An example of full first line of stan- 
dard object code is presented in figure 1 1-4 with the full first line of converted module in High-Low 
format. The numbers being converted are identical to those shown in figure 11-3. 

NOTE 

All HILO conversions begin on a word boundary. Therefore, the 
response to the MEMORY: prompt requires an even-numbered 
address entry for the beginning and end address. 

The following paragraphs describe how to employ this utility program. 

11.2 LUNOs 

The BNPFHL utility program uses LUNOs 10 and 11, which are assigned to the input and output 
pathnames, respectively. 

1 1 .3 LOADING THE BNPFHL UTILITY PROGRAM 

Proceed as follows: 

1. Load the TXDS Control Program in accordance with the step-by-step procedure pre- 
sented in Section II in this manual. 

2. Place the TXDS diskette containing the BNPFHL utility program in an available disc 
drive. 

3. Respond to the PROGRAM:, INPUT:, OUTPUT:, and OPTIONS: prompts as follows: 

PROGRAM: :BNPFHL/SYS 
INPUT: Input Pathname 
OUTPUT: Output Pathname 
OPTIONS: (BNPF) (DUMP ) 

(HILO) , {COMPARE} [ ,B<bias>,I<init>,P<pos>] 

(load ) 

BNPF HIGH/LOW UTILITY 937660 *A 
(where a number is entered for <bias>, <unit>, or <pos> 

MEMORY: <beg addr>,<end addr> 
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Each of the option names may be abbreviated by using the first 
two letters in the option name 






(The MEMORY: prompt is printed or displayed on the system console after the BNPFHL utility 
program is loaded as described in paragraph 1 1 .3.4.) 

The responses to the INPUT:, OUTPUT:, OPTIONS:, and MEMORY: prompts are described in 
the following subparagraphs. 

NOTE 

All numerical input values in response to any of the prompts are 
assumed to be decimal. However, another base may be specified 
by using the following prefixes: 

Prefix Base Example 

! Octal !23 (equals decimall 9) 

> Hexadecimal >23 (equals decimal 35) 

1 1 .3.1 RESPONSE TO THE INPUT: PROMPT. The response to the INPUT: prompt is either the 
pathname of a file or the pathname of a device. One of these two responses must be specified. When "^ 
a DUMP or COMPARE option is specified, the file or device should contain a standard object code 

module. When a LOAD option is specified, the input file or device should contain either a BNPF of 
High-Low formatted module to correspond with the BNPF or HILO response to the OPTIONS: 
prompt. 

1 1 .3.2 RESPONSE TO THE OUTPUT: PROMPT. The response to the OUTPUT: prompt is either 
the pathname of a file or the pathname of a device. One of these two responses must be specified. 
When the COMPARE option is specified, the response to the OUTPUT: prompt should be a file 

which contains a BNPF or a HILO formatted module, depending upon whether a BNPF or a HILO ^'^ 

file is to be compared to the input standard object code. The output device should not be a hard ' 

copy device because no carriage control is included in the output. 

11.3.3 RESPONSE TO THE OPTIONS: PROMPT. The response to the OPTIONS: prompt is 
described in the following subparagraphs. 

NOTE 

All options must be separated by commas. The Bias, Initiahzation, 

and Posifion options can be defaulted as explained below, but, when ^ 

used, must be specified in the following sequence: Bias, Initiahza- 
tion, and Position. 

11.3.3.1 BNPF and HILO Options. The BNPF option specifies a BNPF formatted input or out- 
put module and the HILO option specifies a High-Low formatted input or output module. Either 
the BNPF or HILO option must be specified. The abbreviafions BN and HI may be used, respec- 
tively, instead of the full four characters. When neither the BNPF option or the High-Low option 
is specified, an error results. 

11.3.3.2 DUMP, COMPARE, and LOAD Options. The use of these options is described in the 
following subparagraphs. 

NOTE 

1. One of these options must be specified or an error will result. ^"^^ 
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DUMP (DU) Option. The DUMP option causes the input file in 990 standard object code to be 
^fx^ dumped to the output file in the specified BNPF or High-Low format. 

COMPARE (CO) Option. The COMPARE option is used to verify the results of a DUMP by 
comparing the output BNPF or HILO formatted file to the input file in standard object code 
format. 

When there is no discrepancy in a BNPF COMPARE, the beginning and end address of the com- 
pared information or data are printed on the system console. The following printout is an example 
of a BNPF COMPARE without errors: 

TXDS 936215 *A 1/0 00:02 



PROGRAM 



:BNPFHL/SYS 



DSC2: LIGHTS/OBJ 

DSC2:TEMP/0BJ 

BN.CO 



INPUT 
OUTPUT 
OPTIONS 
BNPF HIGH/LOW UTILITY 937660 *A 
■f^ MEMORY: 0,24 

BEG ADDR=0000 
END ADDR=0018 
TXDS 936215 *A 1/0 00:03 

PROGRAM: 

When there is no discrepancy in a HILO COMPARE, no printout or display is presented on the 
system console. 

^ When a BNPF COMPARE is discrepant, a presentation of the discrepancy is printed out or 

displayed on the system console. An example of a typical printout or display of a discrepancy is: 

T0064=9C M0064=38 

where: 

T represents the BNPF output file; 0064 represents the decimal address of the byte; and 9C 
represents the hexadecimal value of the byte, and 

f^ where: 

M represents the input file in standard object code; 0064 represents the decimal address of the 
byte; and 38 represents the hexadecimal value of the byte. 

The discrepancy is noted by the difference in hexadecimal byte-values 9C and 38. When there 
exists no discrepancy, both hexadecimal byte-values are 38 and, as a result, are not printed out or 
displayed on the system console. 

When a HILO COMPARE is discrepant, a presentation of the discrepancy is printed out or displayed 
on the system console. An example of a typical printout or display of a discrepancy is: 

M0003.<0,3>=0000 T0003.<0,3>=2000 
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where: 



M represents the input file in standard object code; 003 represents the decimal address of the ""^^ 

input file word; 0,3 represents the beginning and ending bit positions of the four-bit string in 
the input object file; and 0000 represents the hexadecimal value of the input file word; and 

where: 

T represents the HILO output file; 0003 represents the decimal address of the output file 
word; 0,3 represents the beginning and ending bit positions of the discrepant four-bit string in 
the output file; and 2000 represents the hexadecimal value of the output file word. 

The discrepant output is presented in hexadecimal word format but, nevertheless, represents the 
High-Low formatted output from the HILO DUMP program execution. In addition, the discrepancy 
is noted by the difference in hexadecimal word-values 0000 and 2000. When there exists no dis- 
crepancy, both hexadecimal word-values are 0000 and, as a result, are not printed out or displayed 
on the system console. 

LOAD (LO) Option. Selection of the LOAD option causes a previously created BNPF or /^ 

High-Low formatted file to be converted into an output file which can be used to program 
P'ROMs using the PROM Programming Module (i.e. the hardware module). Refer to the TXDS 
(TXPROM) Programmer Utility Program section in the TXDS Programmer.s Guide, manual number 
946258-9701. 

11.3.3.3 Bias (B<bias>) Option. The Bias option supplements the DUMP and COMPARE options. 
It defines the number to be added to the address of the relocatable data in the input file as well as 
to the relocatable data itself for the purpose of producing the output file or for the purpose of com- 
paring the input file to the output file. The BIAS option has no effect on nonrelocatable object ^^^^^^^^^ 
module data. The default-substitute produced by the utihty program is 0. An example of the use of ^^ 
the Bias option is presented in paragraph 11.5.5. The bias must immediately follow the B. 

11.3.3.4 Initialization (I<init>) Option. The InitiaUzation option is used to initialize the buffer 
area into which the input file's standard object code is to be read. This initialization is done prior 
to converting the input file to the BNPF or HILO format so that each bit position initially contains 
a 1 or 0. Unused sections of the buffer are also inifialized. The default substitute provided by the 
utihty program for the InitiaUzation option is 0. The operator must enter a or 1 immediately after 
the I. Whenever a number other than or 1 is specified an error results. An example of the use of 
the Initialization option is presented in paragraphs 1 1.5.3 and 1 1.5.4. 



11 .3.3.5 Position (P<pos>) Option. The Position option specifies the first bit of the four-bit string 
from each of the input-file-words (which are in the format of standard object code) that are to be 
converted to the HILO format. A Position option number from through 1 2 is selected by the 
operator to supplement the HILO option selection. The selected number specifies the position 
number of the start-bit of the four-bit string of the 16-bit word from the input file's standard object 
code. An example of the use of the Position option is presented in paragraph 11.5.3. The bit 
position parameter must immediately follow the P. 



^ 



/f^^%. 
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1 1 .3.4 RESPONSE TO MEMORY: PROMPT. The operator's response to the MEMORY: prompt is 
used to sepecily the bounds lor a BNPI' or HILO format. These bounds must be word addresses 
(even) tor HILO format, but may be byte addresses for BNPF format. The first boundary is the 
address of the first word or byte to be formatted. The second boundary is the address of the last 
word or byte to be formatted. The boundaries must be separated by a comma. When the addresses 
are hexadecimal, they must be preceded by a ">" character. It is not necessary to format a whole 
object module. 

Following is an example of a BNPF format MEMORY: prompt. The module was assembled using an 
ADRG >A0 directive which causes the assembler to generate absolute addresses starting at >A0. 
The module is >6C bytes long. 

MEMORY: >A0,>1 OB 

>A0 is the address of the first byte to be formatted and >10B is the address of the last byte to be 
formatted. 

Following is an example of a HILO format MEMORY: prompt. The module was assembled as a 
relocatable module. The module is >5E bytes long. 

MEMORY: 0, >5C 

The address of the first word is zero, the address of the last word is >5C. 

NOTE 

The starting and ending address may be obtained from an assembly 
listing that is generated with the object module. 

In the event the end address entered in response to the MEMORY: prompt exceeds the capacity 
of memory, the CANNOT GET MEMORY error message is printed or displayed on the system 
console. 
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NOTE 

1. The HILO option produces an error message when a byte 
boundary is specified. 

2. The MEMORY: prompt is not issued when the LOAD option 
is used. 

11.4 ERROR MESSAGES 

The error messages that result from misuse of the BNPFHL utiHty are listed in table 1 1-1 with an 
explanation of the cause of each error. 

1 1 .5 EXAMPLES OF USAGE OF THE BNPFHL UTILITY PROGRAM 

Six examples of usage of the BNPFHL utiHty program are presented in the following subparagraphs. 
The standard object code used in each of the examples is presented below. 

TX990 SYSTEM 

riEMDPY SIZEvUDRHS:- : a4':.76 H'v'HlLREiLE: 1£>:44 

. EX-.16.TE. 

TXnS 936215 ♦R I- 00:01, 

PRDGRRM: : TXCCRT-SYS 

I MPUT : D SC2 : L I GHT S -aB J 
OUTPUT: LOG 
DPT I DNS.: SL01JLF55 
TXCCRT 937543 ♦♦ 



:'0006LIGHT":7Friri-;P " " LIGH0003 

LISHrS ■ 0£.-£5.-77 07:aB:01 ^V^mC 947075 ♦£. Hf^fOO? 



LIGH0005 
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Table 11-1. 

Message 

UNABLE TO OPEN FILE 

I/O ERROR ON INPUT 
FILE 



BNPFHL Error Messages 
Cause 

The specified input file does not exist. 
The input file cannot be read. 



,.-^^ 



I/O ERROR ON OUTPUT 
FILE 



The output file cannot be opened and/or 
written to. 



BIT VALUE TOO LARGE. 
MUST BE > C OR LESS 

ILLEGAL FUNCTION COM- 
MAND 

REQUIRED PARAMETER 
MISSING 

INIT VALUE GREATER 
THANl 



The position parameter exceeds Cie . 



The first parameter after the OPTIONS: 
prompt is not HILO or BNPF. 

The second parameter after the OPTIONS: 
prompt is not DUMP, COMPARE, or LOAD. 

The initiaUzation parameter is not or 1 . 



/WSIfc^ 



UNABLE TO OPEN OUT- 
PUT FILE 

ILLEGAL NUMBER INPUT 



The specified output file does not exist. 



One of the numeric parameters is not a legal 
number. 



/^^^ 



ADDRESS WAS NOT ON 
WORD BOUNDARY 



BAD OBJECT FORMAT 



ABORT; SYSTEM ERROR 
FROM XOP 

START ADDRESS GREATER 
THAN END ADDRESS 

CANNOT GET MEMORY 

START GREATER THAN END 
OR LENGTH > 256 WORDS 



One of the addresses after the MEMORY: 
prompt does not begin on a word boundary. 
This error occurs only with the HILO option. 

The input files does not contain legal object 
code. 

A system error flag was returned from an 
XOP. The flag value is printed above the error. 

The first memory parameter is larger than the 
second memory parameter. 

Cannot get memory to run. 

The starting address after the memory: 
prompt is larger than the ending address 
or the difference between the two is greater 
then 256. (This applies only to HILO 
format.) 



/«iK 



-^ 
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11.5.1 EXAMPLE OF BNPF FORMATTED DUMP USING DEFAULT SUBSTITUTE 
PARAMETERS 



TXDS 936215 *A 1/0 

PROGRAM: 

INPUT: 

OUTPUT: 

OPTIONS: 

BNPF HIGH/LOW UTILITY 937660 

MEMORY: 
TXDS 936215 *A 



00:01 

:BNPFHL/SYS 
DSC2: LIGHTS/OBJ 
DSC2: TEMP/OBJ 
BN, DU 
*A 
0.>58 
00:02 



n 



] 


BNMriHHHHNF ] 


BNHPPPMMNF 1 


E.'hHHriNNhHF BHNHHhPPNF BNHMNru-4HNF BNhnr^rir^rinF 


6 ] 


BNMNNNNPNF I 


BNNHNNHriHF BPPPPPPPPF BPPPPPPPPF BMNNNNPPHF BPNPNNhNMF 


Id 


ENriNNNMr-iHF 


BNMPNnHPhF 


BHHNNPHHPF 


ENNNPMriNNF 


BMNHPNPPPF 


BPPPPPPfihF 


18 


BHNNriHPPNF 


BPNPhMHNHF 


BNNHNNNHNF 


BNhPNNHPNF 


BHNrsNPNPHF 


BMMriPN^^^^r•^F 


^4 


BHhNPHF'F'PF 


BPPPPPPNHF 


BNNNPNPPNF 


BPPPPHPPPF 


BHHNNr+PPNF 


BPMPN^^^^^^HF 


30 


BNNHr^HHHMF 


BNNPHHfHPNF 


BNNhPhNHNF 


BPPPPHHPNF 


BHHhNNNPHF 


BHMHHPPNMF 


i!d 


BHNNPPPPPF 


BPPPMMhNHF 


BHNPPNNPMF 


BNNNNHMNNF 


BMHNNHPPHF 


BPPMMNMhHF 


4d 


B.NNPPNNPNF 


BMNNHNNNNF 


BNNNhNPPNF 


BPPNHNhNNF 


BMHrHMNrviPr^F 


BHMNHHNHPF 


49 


BMNMPNNNNF 


BNNNHMNNNF 


. BNNNNNPPMF 


BNhHNNNHPF 


BMNNPMPPhF 


BPPPPPPPNF 


54 


BHNHNNPfHHF 


BHPNPPNPPF 


BMNNtiMNHNF 


BHNNNNnHHF 


BNHNHriNNNF 


BMNNMMNr^HF 


60 


BNNNNHHNNF 


BHHNMhHNNF 


BNHNHhhHhF 


BNHNriNHHhF 


BHNMNNNMNF 


BNriNNNWMF 


66 


BhNNHNNHNF 


BNNNNtiNNNF 


BHNNNNriNNF 


BNHNNr-ihNHF 


BMNMHHMhHF 


BMhhMnriNMF 


7d. 


BNNNNNHNMF 


BNhNHriNriNF 


BMNHhHHMNF 


BNHNNHHHNF 


BNNNNMriHNF 


B^^^^Nr•^rir^r•^r^F 


73 


BhNriHNNriNF 


BHHHHrKiNHF 


BriNHHNNHHF 


BMNNHMMnHc: 


BMNHNHNMNF 


BNNHMNri.NhiF 


84 
i 


BMHtiNNr-iriMF 


BHMHHriHf^hF 


BhriMhNMhNF 


Br•^r•^r•^^^^^r^r^NF 


BHHHHrihfiHF 





^^PIS!^ 
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1 1 .5.2 EXAMPLE OF HILO FORMATTED DUMP USING DEFAULT-SUBSTITUTE 



TXDS: 



:.dl5 ♦H 



1 • u 



Dm: U4 



^fm^ 



PRDGRRM: : BNPFHL- SVS 

INPUT! DSCa: LIGHTS. DEJ 

OUTPUT: DSCa: TE^1P• QBJ 
OP T I QMS: HI^DU 
MEMaRV: Oi. >53 
TXDS: 93r.d\Z ^H 1 

PRDGRRM: : TXCCflT-SYS 
INPUT: DS:C£:TEMP.-DBJ 
QUTPUT: LQG 

TXCCRT 937543 ♦♦ 



000- 


- 7 


LLLL 


LLLL 


LLLL 


LLLL 


HHHH 


LLLL 


LLLL 


LLLL 


00 5- 


-015 


LLLH 


LLLL 


LLLL 


LLLL 


LLLH 


LLLH 


LLLL 


LLLL 


016- 


-0£:-: 


LLLH 


LLLL 


LLLH 


LLHH 


LLLL 


LLHH 


LLLL 


LLLL 


0£*4- 


-051 


LLLH 


LLLL 


LLLH 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


03£'- 


-0 59 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


04 0- 


-04 7 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


048- 


-05 J 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


0":.6- 


-06 5 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


O-r.4- 


-071 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


07 ^- 


-0 79 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


03 0- 


-0*57 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


OdE:- 


-095 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


O?^- 


-105 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


1 04- 


-111 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


llE*- 


-119 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


1 so- 


-1£7 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


le: S- 


-155 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


1 36- 


-145 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


144- 


-151 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


15£- 


-159 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


Irf.O- 


-167 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


163- 


-175 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


176- 


-185 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


154- 


-191 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


19c'- 


-199 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


£'00- 


-£07 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


d El- 


-£15 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


s' 16- 


-£'£' 5 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


£•£•4- 


-£51 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


£3£- 


-£59 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


£4 0- 


-£47 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


£48- 


-£55 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 


LLLL 



.y^<!S^|y 
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/^^w\ 



y^ff*\ 



11.5.3 EXAMPLE OF HILO FORMATTED DUMP BEGINNING AT POSITION 4 AND OF 
INITIALIZING THE BUFFER TO ALL BINARY ONES 



TXDS: 



^56dl==i ♦!=• 



1- 



PRDGRRM: : BNPFHL- SYS 
I NPUT : nSCE- : L I GHTS-- DB J 
aU TP'UT : D iCc' : TEMP -a B J 
aPTiariS: HI!.DLM1?P4 
MEMaPV: LN >58 
rXDS: 9 36£15 ♦H 1- U 

PRDGRflM: : TXCCRT-SYS 
input: DSC£:TEMP."DBJ 

GUT«='UT: LOG 
QPTIOHS: i:L01.LP55 
TXCCRT 957543 ♦♦ 



000- 


-007 


LLLL 


LLLL 


LLLL 


LLHL 


HHHH 


LHHL 


LLLL 


HLLH 


00 5- 


-015 


LHHH 


LHHL 


LLLL 


HLHL 


LHHH 


LHHL 


LHHL 


LLLL 


016- 


-033 


LLLL 


LLHL 


HHHH 


LLHL 


LHHL 


LLHL 


LHHL 


LLHL 


0£'4- 


-051 


LLLL 


LHHL 


LHHL 


LHLL 


HHHH 


HHHH 


HHHH 


HHHH 


o:-:fj- 


-0 59 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


04 0- 


-047 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


048- 


-055 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


056- 


-065 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


064- 


-071 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


C\7d' 


-079 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


03 0- 


-037 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


033- 


-095 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


096- 


-105 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


1 04- 


-111 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


lli- 


-119 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


1£"0- 


-137 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


1^3- 


-155 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


136- 


-145 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


144- 


-151 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


153- 


-159 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


160- 


-167 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


163- 


-175 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


176- 


-135 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


134- 


-191 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


193- 


-199 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


300- 


-3 07 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


303- 


-315 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


316- 


-335 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


334- 


-351 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


333- 


-3 59 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


34 0- 


-347 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


343- 


-355 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 


HHHH 



J^^^\ 
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1 1 .5.4 EXAMPLE OF A HILO COMPARE WITH DISCREPANT DATA. The file generated in the 
example in 1 1 .5.3 is compared to the first hexadecimal number in the words of the standard object 
code file (positions 0-3) instead of the second hexadecimal number in the words of the standard 
object code file (positions 4-7) that was used in generating the file presented in paragraph 11.5.3. 



^ 



TXDS: 936dl' 



U n : 1 1 



PRDGRRM: :BNPFHL. S 


YS 








INPUT: DSCa: LIGHTS. DB- 








OUTPUT: DSCd: TE^-I^ 


• QBJ 








QPTIDMS: H 1 1. CD ill 










^•lEMaf^'Y: U!. <58 










ILLEGRL NUMFEP INPUT 








TXDS ^^^.^l^ ♦R 


1- 


:i 00: 15 




PRDGRRM: : BNPFHL-S 


YS 








INPUT: uses: LIGHTS. DE.. 








OUTPUT : D S:C V : TEMP -a B J 








OPT I DNS: HI-.CaiIl 










MEMDRV: U!. >53 










f'1 U 3 . '•. !• 5 • = 


T 3 


■: !• 3 


:• =c'0 00 


M 


M 7 . »: 9 3 • = ij 


TOOOr 


OJ!" : 


:'=?000 


M 


M U '? . ' !• 3 :• = 


TOOO-? 


' !• 3 


' =6 00 


M 


N OC . •:. 9 3 :• = 1 


TOOOC 


•■ 9 ~Z 


:• = 7 


M 


NOOOE. '.ri!. :-::• =0001:1 


TOOOE 


•: 9 2 


:• =60 


M 


M Oil. '-. !• 5 ' = 


TOOll 


•:. !• 3 


>=dOOO 


M 


M 1 :-: . •: !• 5 • = 5 


TOOi:-: 


•:. !• z 


:'=c'0 00 


M 


M0015. '.0, 5:'=5000 


TOOI 5 


•: !» 2 


:'=c:0 


M 


NOOl?. (O* 5:- =0000 


T0017 


•:0, : 


:• =c'0 


M 


M 1^1 1 9 . '■ !• 3 > = 


rooi? 


•: ' 3 


'=60 


M 


N 1 B . '■ !• 5 :• = 


TOOIB 


OJi :- 


'=4000 




TXDS '^Be^lS ♦R 


1- 


j r 


0:19 





05 


'0. 3 


• = u u u 


08 


': n 3 


'=100 


OB 


'.JJ!. 3 


• = 


OOOD 


i « 5 


'=100 


0010 


'•U!' 3 


:'=100 


001c' 


•: 9 3 


:'=100 


0014 


•• 9 3 


'=000 


0016 


• !. :-i 


:. =0 


0018 


• 0-. :■: 


.'=100 


Ij 1 R 


•rOi. 5 


'=100 



\'\ 


TO 005 





T0 008 





T B 





TOOOD 





TO 010 





T0 01£' 





T0014 





T0016 





T0018 





TOOIR 



'• U 9 

< 9 
•• 9 

»:. !• 

•:. !• 

'• • 

•■. 9 

< 9 

•■ !• 

'■ 9 



'■' =6 0C 
' = 7 f 
■f =1=111 01; 

:i =6 0i; 
'■' = 1. 
' =FOOC 
:• =60 0C 
:« =60 01! 
• = f. 
' =60 OC 






^ 



■^ 



^.^a^^s*,. 
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1 1 .5.5 EXAMPLE OF A BNPF FORMATTED DUMP WITH BIAS 1 00 



PRDGRflM: : BNPFHL.-SYS 

INPUT: riSC2:LIGHTS.-nBJ 
GUTPUr: DiCa: TEMP- OB J 
Qp'TIQr-li:: BMi-DU!. BlOO 
MEr-IORV: 0, ;:riy 

PRDGRRM: : TXCCRT.--SVS 
INPUT: riSC:£:TEMP.DBJ 

QUrPUT: LOG 
ac'TIDNS: i:Li:il»LP^5'5 
TXCCRT 9 57':i4:: ♦♦ 



10 


BNNNHNNHNF 


BPHNPPPNHF 


BHMNNNHHNF 


BNPPNPNPNF 


BNNNNNNNNF 


BNNNNNNNNF 


1 06 


BNNNHNNPNF 


BHMNhNHNNF 


BPPPPPPPPF 


BPPPPPPPPF 


BNNNNNPPNF 


BPNPNNNNNF 


11^ 


BNNNNHNHNF 


BPNNNHPPNF 


BNNNNPNNPF 


BNNNPNNNNF 


BNNNPNPPPF 


BPPPPPPNNF 


115 


BNNNNNPPNF 


BPNPNNNNNF 


BNHNNNHHNF 


BPNNNNPPNF 


BNNNNPNPNF 


BNNNPNNNNF 


1£*4 


BMNNPNPPPF 


BPPPPPPNHF 


BNNNPMPPNF 


BPPPPNPPPF 


BNNNNNPPNF 


BPNPNNNNNF 


130 


BNNNNNNNHF 


BPNNNNPPNF 


BHNNPNNNNF 


BPPPPNNPNF 


BNNNNNNPNF 


BNNNNPPNNF 


136 


BNNNPPPPPF 


BPPPHNNNNF 


BNNPPNNPNF 


BNNNNNNNNF 


BNNNNNPPNF 


BPPNNNNNNF 


14d 


BNMP'PNNPNF 


BNNNNNNNHF 


BNHNHhPPNF 


BPPNNNNNNF 


BNNNNNNPNF 


BNNNNNNNPF 


148 


BNrihPMNHNF 


BNMNNHNHNF 


BNNNNNPPNF 


BNNNNNNNPF 


BNNNPNPPNF 


BPPPPPPPNF 


154 


BMNNHNPHNF 


BHPNPPNPPF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


16 


BNNNNMNHNF 


BNNNNNNHHF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


166 


BNNNNNHNNF 


BNNNHNNNHF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNP 


BNNNNNNNNF 


172 


BMNNNNMNNF 


BNNNNNHNNF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


1?? 


BHNNNNNNNP 


BNNHHNNHNF 


BNNNNNNNNF 


BNNNNNNNNP 


BNNNNNNNNF 


BNNNNNNNNF 


134 


BNNHMNNNNF 


BNNNHhNNNF 


BNNNNNNNNF 


BNNNNNNNNF 


BNNNNNNNNF 





11.5.6 EXAMPLE OF A BNPF COMPARE WITH DISCREPANT DATA. The BNPF file which is 
used is the one created in paragraph 11.5.5 with Bias option 100; however, the COMPARE was 
performed without the Bias option. 



TXtii 



•9 36:31' 



♦ H 



: c 1 



PRDGRflM: : BNPFHL-SYS 

INPUT: BSi::£:LIGHTS.-'DBJ 

GUTPUT: DS:Ca:TEric-..aBJ 
a-'TIQNS: BNi-Ca 
^1Er•1DPV: Oi >5S 
BEG »=lDDP=0064 
X I j 64=9 C M 64=3 
T 7 = '3 6 M 7 = 5 £' 
T 1'' 6 = 3 6 M u i" 6 = c" c* 
T 3 3 = 3 6 M n '3 cr= c! d 
END hDDP=0053 
T:DS: 95631S ♦»=♦ 1 



J u n ^:. 4 = ii|. H f') 64= 6 



uu: dc 
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( SECTION XII 

TXDS IBM CONVERSION UTILITY (IBMUTL) PROGRAM 

12.1 INTRODUCTION 

The IBM Conversion Utility (IBMUTL) Program provides a means of transfemng standard IBM 
formatted diskette datasets to TX990 files and transferring TX990 files to standard IBM for- 
matted diskette datasets. IBMUTL also provides a means of formatting diskettes to standard IBM 
specification for a single density diskette as designated in "The IBM Diskette For Standard Data 
Interchange", GA2 1-9 182-0. 

12.2 IBMUTL DESCRIPTION 

IBMUTL allows the user to read or v^rite datasets on an IBM formatted diskette in a form that 
can be read and used by systems and devices that are based on IBM sequentially sectored diskettes 
using the EBCDIC character set. The IBM formatted diskette may already contain datasets created 
^ by another process or may have been newly formatted by this utiUty or other means. All pre- 

existing datasets will be preserved. 

12.2.1 FORMATTING IBM DISKETTE. The diskette is formatted to IBM format by entering 
the format command. If more than two bad tracks are found, or if track zero is bad, the diskette 
is unuseable and another diskette should be used. Track zero contains the dataset headers (sectors 
8-26) and other information about the diskette (sectors 1-7). The dataset headers are written to 
include name, record length, beginning of extent (BOE), end of extent (EOE), and end of data 
(EOD) fields only. All others are left in the initiahzed state (blank). 

' 12.2.2 TRANSFERRING TX990 FILES TO IBM DATASETS. TX990 files that are to be con- 

verted to IBM format must be specified by the operator with a standard TX990 pathname. The 
new dataset will begin with the first available label following the last used label in the IBM diskette 
directory. Empty labels between used labels are skipped by this directory. The name of the new 
dataset may be the same as an already existing dataset but the existing dataset will not be replaced. 

12.2.3 TRANSFERRING IBM DATASETS TO TX990 FILES. The operator must specify the 
desired dataset label and the TX990 pathname. The dataset labels from the IBM diskette are dis- 
played when the transfer command is entered. If the TX990 file does not already exist, 
r^ It will be created as a noncontiguous sequential file. If two datasets have the same name[ 

only the first dataset may be accessed by this utihty. 

12.3 LUNOS AND THEIR USES 

This utility uses the console device assigned to LUNO 15 15 as the interactive device. If LUNO 15i6 

is not assigned, the system console is used. LUNO 1 1 ^g is assigned to the drive in which the IBM | 

diskette is mounted; LUNO 10 15 is assigned to the TX990 file. I 

12.4 LOADING AND EXECUTING 

IBMUTL can be executed using OCP or the Terminal Executive Development System (TXDS). 
« If OCP is used, follow the procedure below: 

1 . Ready the device which contains the object program for IBMUTL. 

2. Load the program into memory using OCP. IBMUTL must be loaded as a privileged 
( task. 
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LP,CS1,3,P. if loading the IBMUTL object program from 

cassette drive one as a privileged task 

LP,:IBMUTL/SYS,3,P if loading the IBMUTL object program from 

the system diskette drive, file :IBMUTL/SYS, 
as a priority level 3 privileged task 

3. Execute the program, and terminate OCP. 

EX,10.TE. 

If the IBMUTL object program is linked into the system, omit steps 1 and 2 and simply 
execute the task using the task ID assigned to it at that time. 

If the TXDS control program is used, follow the procedure below: 

1 . Ready the device which contains the object program for IBMUTL. 

2. Enter the name of the device or file which contains the object program in response to 
the PROGRAM: prompt. Specify IBMUTL to be loaded as a privileged tasH by following 
the device or file name with ",P". 

PROGRAM: CS1,P* if loading the object program on cassette drive 

one and executing as a privileged task 

PROGRAM: :IBMUTL/SYS,P* if the object program in the file :IBMUTL/SYS 

on the system diskette drive and executing as a 
privileged task 

12.5 OPERATOR INTERACTION 

12.5.1 SPECIAL CHARACTERS. There are two special characters recognized by IBMUTL. They 
are as follows: 

* When entered in response to a prompt and followed by a carriage return, IBMUTL is 
terminated. 

& When entered in response to a prompt and followed by a carriage return, IBMUTL 
restarts by requesting the IBM diskette drive name. 

12.5.2 OPERATOR PROMPTS. When the task has been loaded and executed, the task name and 
revision level are printed followed by a request for the IBM floppy diskette drive name. 

TI FLOPPY DISK IBM CONVERSION TASK. PN 936216 ** 

IBM DISK DRIVE NAME: 

The required service is selected in response to the next query. 

SERVICE? F-FORMAT. T=TRANSFER: 



,y^^m^ 



^ 
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When format is selected, no further interaction is necessary. The format process is executed to 
completion and the following messages are displayed. 

FORMAT IN PROGRESS . . . 

FORMAT COMPLETE. 

The utiUty will then request the IBM diskette drive name again. 

When one of the transfer services is selected, the IBM diskette is checked for proper format and a 
list of the labels is displayed. When the IBM format is found to be incorrect, a message is displayed 
and the diskette name request is repeated. (Operator responses are underlined; (C/R) represents a 
carriage return). Upon responding with a "T" for the transfer function, the following messages 
are output: 

FILEl All dataset labels on the IBM format diskette are listed. 

FILE2 



FILES 



NOTE 

While listing the dataset labels of the IBM formatted diskette, blanks 
are printed when a dataset is encountered in which the label contains 
all blanks. 



or, 



** DISKETTE NOT IBM FORMAT ** Specified diskette is not an IBM formatted 

diskette. 

At this point, if the format is correct, the program is ready to perform the transfer operation. 
The direction of transfer is established by response to the next query. 

FUNCTION? F=FILE TO DATASET, D=DATASET TO FILE: F 

or D 

Whether or not an "F" or a "D" is selected, the next question asked is: 

CHARACTERS PER RECORD? 2 MIN. - 128MAX: 80(C/R) 
When only a carriage return is entered, the default value is 80 characters per record. 
The TX990 user file pathname and IBM dataset names are requested next: 

USER FILE PATHNAME: DSC2 : SOURCE/ABC(C/R) 

DATASET NAME : SOURCE(C/R) 

FILE TRANSFER IN PROGRESS. . . 
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Pathname can be defaulted to the first six characters of the dataset name when transfer is dataset 

to file; or when transfer is file to dataset, the dataset name can be defaulted to the file name portion ^^'^^^ 

of the pathname. The default substitute is specified by a carriage return (C/R) response to the 

query. Pathnames that are preceded by a colon are defaulted to the system diskette drive. 

When the IBM diskette is not filled at the completion of converting the specified file, IBMUTL 

requests the record size again. ^ 

When it is desired to reverse the transfer function or change the drive on which datasets are being 
accessed, an ampersand (&) symbol reply returns the program to the point where the diskette 
name is requested: ^ 

USER FILE PATHNAME: &(C/R) 
Responding with an ampersand (&) returns program control to the initial user prompt: 

IBM DISK DRIVE NAME: 
If the user enters an asterisk (*), IBMUTL terminates with the following message; 

UTILITY SERVICE TERMINATED 

12.6 ERROR REPORTING AND RECOVERY 

Errors encountered during execution of IBMUTL are reported to the operator in accordance with 
table 1 2-1 . Whenever recovery from such errors is possible, the program returns to a logical restart 
point and continues its function. 



^ 



XSB^ 



^'"'^v 
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SECTION XIII 
TXDS ASSIGN AND RELEASE LUNO UTILITY PROGRAM 



13.1 INTRODUCTION 

The TXDS LUNO Utility provides a means of assigning and releasing Logical Unit Numbers 
(LUNOs) without having OCP linked in with the TX990 operating system. This capability is 
especially necessary in order to execute FORTRAN programs without OCP. 

1 3 .2 LOADING AND EXECUTING 

The LUNO utility is executed through the TXDS Control Program, by responding to the 
PROGRAM: prompt in the following manner: 

PROGRAM: :TXLUNO/*<cr> 

13.3 OPERATOR INTERACTION 

When the LUNO utility starts execution, it displays the following identification message: 

ASSIGN & RELEASE LUNO 939888** 

13.3.1 OPERATOR PROMPTS. After the heading is displayed, the LUNO utility displays two 
prompts, in the following order: 

LUNO? 
PATHNAME? 

The user enters the logical unit number being assigned or released in response to the LUNO? 
prompt. LUNOs may range from to 255. If the user desires to enter a hexadecimal value, it must 
be preceded by a ">" sign. 

If the LUNO is being assigned, the user enters the pathname of the file or device to which the 
LUNO is to be assigned in response to the PATHNAME? prompt. If the LUNO is to be released, 
the user should enter a carriage return in response to the PATHNAME? prompt. 

The following example assigns LUNO 33 to a file and releases LUNO Ajg. User responses are 
underlined. 



PROGRAM: :TXLUNO/SYS * <cr> 

ASSIGN AND RELEASE LUNO 939888** 

LUNO? 33<cr> 

PATHNAME? VOL2 :TASK 1 /SRC <cr> 

LUNO? >A<cr> 

PATHNAME? <cr> 

LUNO? *<cr> 
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13.3.2 SPECIAL CHARACTERS. The LUNO utility recognizes two special characters which may 

be entered in response to a prompt: '^^ 

* Terminates the utiUty. 

& Restarts the utiUty at the LUNO? prompt. 

1 3 .4 ERROR MESSAGES AND RECOVERY 

The LUNO utility may return the following error message: 

I/O ERROR, nn 
where nn is one of the I/O error codes in APPENDIX D. 
To recover from the error, retry the LUNO Assign or Release operation. 



^ 
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f ^ APPENDIX A 

GLOSSARY 

Boot Program - A program that loads the Operating System into memory and starts the Operating 
System executing. 

COMMON - An area of memory which may be coded by use of the TXDS Control Program and 
the system console keyboard (e.g., a 733 ASR, a 91 1 VDT) or by means of a task-specified- 
code and then made accessible for use by a task through the Get COMMON Data address 
supervisor call. The size of the system COMMON memory area is determined by a system 
parameter specified when the system is generated. 

Default-substitute - A substitute pathname, or field of a pathname, provided by some utility 
programs when the program or keyboard-entry does not supply the data. 

Device Name Table - A table accessed by the File Management supervisor call to obtain the address 
of the Physical Device Table (PDT) corresponding to a device name. Contains all device names 
defined in the system and addresses of the PDTs for the devices. 

Device Service Routine - A routine of the TX990 Operating System that controls I/O operations 
with a device. 

DNT - Device Name Table. 

DSR - Device Service Routine. 

Dynamic Task Area - The area of memory occupied by task lOje-Task lOj^ can be loaded by 
using the Operator Communication Package (OCP) or the TXDS control program. 

End-of-file - A record in a file (either logically or physically) that marks the end of the file. The 
character sequences that denote end-of-file for the file-oriented supported devices are shown in 
Appendix B. 

End-of-record - A character of a record that marks the end of the record. The characters that 
denote end-of-record for supported devices are shown in Appendix B. 

EOF - End-of-file. 

EOR — End-of-record. 

GENTX - The system generation task, which obtains system parameters interactively from the 
keyboard of the LOG. GENTX builds source statement files from which modules TXDATA 
and TASKDF are assembled. 

IDT — Program identifier of the source module. 

Initial Program Load - The loading of a TX990 system placing the module in memory and starting 
execution of the system. 
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I/O Supervisor - The portion of TX990 that processes I/O supervisor calls, and passes control to 
the Device Service Routine (DSR) for the device. 

IPL - Initial Program Load. 

Keyboard Status Block (KSB) - A data structure in TXDATA used for character mode I/O with a 
VDT. TXDATA includes a KSB for each VDT. 

KSB - Keyboard Status Block. 

LDT - Logical Device Table. 

Logical Device Table (LDT) - A table in TXDATA that contains a Logical Unit Number (LUNO) 
and the address of the Physical Device Table (PDT) that corresponds to the device assigned to 
the LUNO. 

Logical Unit Number (LUNO) ~ A number by which an I/O operation specifies the device for the 
operation. 

LUNO - Logical Unit Number. 

OCP - Operator Communication Package , 

Operator Communication Package (OCP) - A package of modules that contains the routines 
for the commands by which the operator or user communicates with TX990. 

PC - Program Counter. 

PDT - Physical Device Table. 

Physical Device Table (PDT) ~ A table in TXDATA that contains device-related data required by 
the Device Service Routine (DSR) in an I/O supervisor call for the device. 

Program Counter (PC) - A register in the computer hardware that contains the address of the next 
instruction to be executed. 

Status Register - A register in the computer hardware that contains condition bits and the inter- 

rupt mask. ^ 

Supervisor Call Block - A block of memory that defines a supervisor call, addressed by the super- 
visor call instruction. The code of the supervisor call is in byte of the supervisor call block. 
The number of additional bytes (if any) and the content of the additional bytes are defined for 
each supervisor call. 

Supervisor Call Table - A table in TXDATA in which entry points to supervisor call routines are 
listed in a supervisor call code order. 

Task Data Division - One of two logical divisions within a task. The data division contains one or 
more workspaces, data structures, supervisor call blocks, and data for the task. A data division 
may or may not be assembled separately from the procedure division of the task, and is not 
shared with any other task. 

Task Management - Task Management maintains a state code for each task. The state codes are "^j 

listed in Appendix C. 



,><^^ 
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Task Scheduler - Initiates execution of a user task. When the currently executing task completes 
a time sHce, the task scheduler passes control to the oldest task on the active list for the 
highest priority (0). If there is no task on the active list for priority 0, the oldest task on the 
active list for the next highest priority receives control. 

Task Status Block (TSB) - A data structure in TXDATA used by the TX990 Operating System to 
control execution of the task. 

Task Time Delay - The result of a task executing a Time Delay supervisor call. The Time Delay 
supervisor call suspends the calling task for a specified number of 50 ms periods. 

Task Time SUce - A period of execution of a task having a maximum length defined when the 
system is generated. A task time slice begins when the task scheduler passes control to the task. 
A task time sHce ends: (1) when the system suspends the task upon expiration of the 
maximum time period allowed for a task time slice; (2) when the task executes a supervisor 
call that suspends the task; (3) when the system suspends the task to await completion of an 
I/O operation. To avoid completely locking out low priority tasks, there is a maximum number 
of consecutive time slices (weighting factor) for each priority level. When the number of time 
r^ sHces has been used by a priority level, the oldest task on the active list for the next lower 

priority is allowed a time slice before the higher level again has control. The maximum number 
of time slices for each priority level are system parameters defined when the system is 
generated. The maximum period of a time slice may be extended by execution of a Do Not 
Suspend supervisor call. The time slice is less than the maximum time period when the task 
suspends itself, or is suspended awaiting completion of an I/O operation. 



Task Weighting Factor - A count of task time slices for a priority level. When the number of task 
time slices specified as the weighting factor for priority level has been used by tasks at that 
priority level after a task at a lower level has had control, a task at a lower priority level 
receives control for a time slice. 

Task Area, Dynamic - Memory area where task 10 resides (see Dynamic Task Area and Task, Uses, 
Loading oQ. 

Task, Bid - To start execution of a task causing the TX990 Operating System to enter the task on 
the active list according to its priority level. 

Task, Debugging of a - The process of removing errors from a task. 

Task, Diagnostic (DTASK) - A system task that terminates a task when fatal errors occur in the 
task, and prints an error message. 

Task, Executing a - Controlling the processor and the resources of the computer. 

Task, Linked - Consists of separately assembled modules that have been combined by resolving 
external references and definitions in the modules to form a single executable module. 

Task, LIST8080 - A utility task that copies 80-character records from one device to another. 

Task, Loaded - A task copied from an external storage medium into the memory of the computer 
in preparation for execution. 

Tasks, Multiple - Two or more tasks concurrently active in an operating system. 
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Task, Procedure Division - One of two logical divisions within a task. The procedure division 

contains the executable code for the task. A procedure division may or may not be assembled ""^ 

separately from the data division of the task and may be shared with other tasks. 

Task, Suspended - A task temporarily removed from the active list and from execution as a result 
of a supervisor call or during an I/O operation. 

Task, Terminated - A task removed from execution and from the active list either at normal 
completion or at an abnormal termination initiated by the operator or by the diagnostic task 
when a fatal error is detected. 

^^ 
Task, User, Loading of - The task loaded into the dynamic task area using the OCP LPROG 
command. 

Task, Waiting - A task waiting for completion of an I/O operation or for a system function or 
resource. 

Workspace - A 16-word area of memory addressed as workspace registers through 15. The active ,^ 

workspace is defined by the contents of the workspace pointer register. 

Workspace Pointer (WP) — A register that contains the address of workspace register 0. 

Workspace Register — A memory word accessible to an instruction of the computer as a general 
purpose register. It may be used as an accumulator, a data register, an index register, or an 
address register. 



WP - Workspace pointer register. 
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COMPRESSED OBJECT CODE FORMAT 
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APPENDIX C 
TASK STATE CODES 

The user-task supervisor calls which return one of the task state codes listed in table G-1 to byte 1 
of the supervisor call block are: 

• Bid Task Supervisor Call 

• Activate Suspended Task Supervisor Call 

• Activate Time Delay Task Supervisor Call 

The user may code his program to read out the task state code to an output device or, using the 
OCP STate (ST) command, the user can cause a terminal to print out the task state codes. 

Table C-1. List of Task State Codes 



^^^ 



Code 




(Hexadecimal) 


Significance 


00 


Active task, priority level 


01 


Active task, priority level 1 


02 


Active task, priority level 2 


03 


Active task, priority level 3 


04 


Terminated task 


05 


Task in time delay 


06 


Suspended task 


07 


Currently executing task 


08 


Task awaiting VDT character input 


09 


Task awaiting completion of I/O 


OA 


Task queued for I/O 


OB 


Task queued for file utility routine 


OC 


Task on the diagnostic queue 


OD 


Task waiting for file management completion 


10 


Task queued for file management 
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APPENDIX D 
I/O ERROR CODES 



Code 




(Hexadecimal) 


Description 




DSR ERRORS 


00 


NO ERROR 


01 


ILLEGAL LUNO 


02 


ILLEGAL OPERATION CODE 


03 


LUNO IS NOT YET OPENED 


04 


RECORD LOST DUE TO POWER FAILURE 


05 


ILLEGAL MEMORY ADDRESS 


06 


TIME OUT, OR ABORT 


07 


ILLEGAL DEVICE 


11 


DEVICE ERROR 


12 


NO ADDRESS MARK FOUND 


15 


DATA CHECK ERROR 


19 


DISKETTE NOT READY 


lA 


WRITE PROTECT 


IB 


EQUIPMENT CHECK ERROR 


IC 


INVALID TRACK OR SECTOR 


ID 


SEEK ERROR OR ID NOT FOUND 


IE 


DELETED SECTOR DETECTED 



FILE MANAGEMENT ERRORS 

20 LUNO IS IN USE 

21 BAD DISC NAME 

22 PATHNAME HAS A SYNTAX ERROR 

23 ILLEGAL FUR OPCODE 

24 BAD PARAMETER IN PRB 
f^ 25 DISKETTE IS FULL 

26 DUPLICATE FILE NAME 

27 FILE NAME IS UNDEFINED 

28 ILLEGAL LUNO 

29 SYSTEM BUFFER AREA FULL 
2A SYSTEM CANT GET MEMORY 
2B FILE MANAGEMENT ERROR 
2C CAN'T RELEASE SYSTEM LUNO 
2D FILE IS PROTECTED 

2E ABNORMAL FUR TERMINATION 

2F SUPPORT FOR OPTION DOES NOT EXIST IN SYSTEM 

30 NON-EXISTENT RECORD 

3B INVALID ACCESS PRIVILEGE 

3E FILE CONTROL BLOCK ERROR 

3F FILE DIRECTORY FULL 
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I/O ERROR CODES (Continued) 



^ 



Code 
(Hexadecimal) 



60 
61 
62 
63 
64 



80 



Description 



TASK LOADER ERROR 



I/O ERROR, LOAD NOT COMPLETE 

OBJECT MODULE CONTAINS NONRELOCATABLE OBJECT CODE 

CHECKSUM ERROR LOAD ABORTED 

LOADER RAN OUT OF MEMORY 

TASK 10 IS BUSY 



VDT ERRORS 



DEVICE NOT AVAILABLE 
VDT STATION NOT FOUND 



^ 



Note: 

Error Code >FF is a general error code. 
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ALPHABETICAL INDEX 

INTRODUCTION 

-« 

The following index lists key words and concepts from the subject material of the manual 
together with the area(s) m the manual that supply major coverage of the listed concept The 
numbers along the right side of the listing reference the following manual areas: 

• Sections - References to Sections of the manual appear as "Section x" with the symbol 
X representing any numeric quantity. 

e Appendixes - References to Appendixes of the manual appear as "Appendix y" with the 
symbol y representing any capital letter. 

f^ • Paragraphs - References to paragraphs of the manual appear as a series of alphanumeric 

or numeric characters punctuated with decimal points. Only the first character of the 
string may be a letter; all subsequent characters are numbers. The first character refers 
to the section or appendix of the manual in which the paragraph is found. 

• Tables - References to tables in the manual are represented by the capital letter T 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the table). The second character is followed by a 
dash (-) and a number: 

Tx-yy 

• Figures - References to figures in the manual are represented by the capital letter F 
followed immediately by another alphanumeric character (representing the section or 
appendix of the manual containing the figure). The second character is followed by a 
dash (-) and a number: 

Fx-yy 

• Other entries in the Index - References to other entries in the index are preceded by 
the word See followed by the referenced entry. 
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Address Parameter, PROM Starting . . . 10.7.10 

After Parameter, Compare 10.7.4 

Assembling Source Programs Section V 

Base Parameter, CRU 10.7.26 

Bias: 

Option 11.3.3.3 

Parameter, Data 10.7.2 

Bit: 

Memory Starting 10.7.9 

PROM Starting 10.7.12 

BNPF: 

Compare 1 1.3.3.2 

Format Ill 

HILO Option 11.3.3.1 

BNPFHL Section XI 

Error Messages Tl 1-1 

BOE 12.2.1 

Bottom (B) Command 4.4.6.4 

Breakpoint 9.5 

Change Command 4.4.7.1 

Characters: 

Special 12.5.1, 13.2.2 

Code Format: 

Compressed Object Appendix B 

Object 11.1 

Code Parameter, Transfer 10.7.3 

Codes: 

I/O Error Appendix D 

Task State Appendix C 

Command: 

CB 9.6.6.2 

CP 9.6.13.2 

CR 9.6.12.3 

CS 9.6.11.3 

EX 9.6.1 

FB 9.6.4 

FW 9.6.5 

HA 9.6.3 

IC 9.6.7.1 

IM 9.6.8.1 

IR 9.6.9.1 

IS 9.6.11.2 

MC 9.6.7.2 

MM 9.6.8.2 

MR 9.6.9.2 

MW 9.6.10.2 

RU 9.6.2 

SB 9.6.6.1 

SP 9.6.13.1 

SR 9.6.12.2 

SS 9.6.11.1 

ST 9.6.12.1 

Bottom (B) 4.4.6.4 

Change 4.4.7.1 

Down (D) 4.4.6.1 

End (E) 4.4.9.3 

Find (F) 4.4.7.5 

Move (M) 4.4.7.3 

Print 4.4.8.2 

Print Margin 4.4.5.3 

Remove 4.4.7.4 



Set Margin (SM) 4.4.5.4 

Start Line Numbers (SL) 4.4.5.1 

TXDBUG Stop Numbers (SN) 4.4.5.2 

Top (T) 4.4.6.3 

Up (UP) 4.4.6.2 

Commands: 

Debug 9.5 

Operands 4.4.2 

TXDBUG Keyboard T9-2 

TXEDIT 4.1 

Compare: 

After Parameter 10.7.4 

BNPF 11.3.3.2 

HILO n.3.3.2 

Option 11.3.3.2 

Compressed Object: 

Code Format Appendix B 

Option 7.4.2, 5.4.6 

Console, System 11 

Control: 

File 10.5 

Creation 10.5.1 

Execution 10.5.3 

Modification 10.5.2 

Parameter Prompts TlO-1 

Files 10.7 

Standard 10.9 

Keys, Special Keyboard 2.3.3 

Options, TXLINK 7.4 

Program: 

TXDS 1.L2.1 

Copy/ Concatenate Utility Program, 

TXDS Section VUI 

Creation, Control File 10.5.1 

Cross-Reference: 

Option 5.4.2 

Utility Program, TXDS Section VI 

CRU Base Parameter 10.7.26 

Data Bias Parameter 10.7.2 

Debug: 

Commands 9.5 

Modes 9.4 

Debugging Techniques 9.7 

Default Value 2.3.1 

Defaults: 

Pathname T5-1, T6-1, T7.1, T8-1 

Device Name 2.3.1 

Down (D) Command 4.4.6.1 

Dump Option 1 13. 3. 2 

Duty Cycle Parameter 10.7.23 

EBCDIC 12.2 

Editor, Link 7.1 

End (E) Command 4.4.9.3 

E-OD 12.2.1 

EOF 12.2.1 

Error: 

Codes, I/O Appendix D 

Message, TXEDIT T4-3 

Messages: 

BNPFHI Tll-1 

IBMUTI T12-1 
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Messages: (Continued) 

TXDBUG 9.8 

TXDS Character Program T2-3 

TXLINK T7-3 

TXLUNO 13.4 

TXMIRA 5.5.1 

TXPROM 10.13 

TXXREF T6-2 

Errors: 

TXCCAT T8-3 

TXMIRA: 

Fatal T5-4 

Nonfatal T5-5 

EX Command 9.6.1 

Execute Free Mode .9.4 

Execution, Control File 10.5.3 

Exposure Techniques 9.7 

Extension 2.3.1 

Fatal Errors, TXMIRA T5-4 

File: 

Control 10.5 

Creation, Control 10.5.1 

Execution, Control 10.5.3 

Input 4. 1 

Modification, Control 10.5.2 

Name 2.3.1 

Option, List 8.4.4 

Parameter Prompts, Control TlO-1 

Scratch 4.1 

Filename Identifiers, Utility Program . . . .T2-2 

Files: 

Control 10.7 

Standard Control 10.9 

Find (F) Command 4.4.7.5 

Fix Records 8.4.2 

Format: 

BNPF 11.1 

Compressed Object Code .... Appendix B 

High-Low ll.l 

Object Code 11.1 

Formats, Trace 9.6.12.1 

Free Mode, Execute 9.4 

Glossary Appendix A 

High-Low Format 11.1 

HILO: 

Compare 11.3.3.2 

Option, BNPF 11.3.3.1 

I/O Error Codes Appendix D 

IBMUTL: Section XII 

Error Messages T12-1 

IC Command 9.6.7.1 

Identifier Option, Program 7.4.3 

Initialization Option 11.3.3.4 

Input: 

File 4.1 

Prompt 2.3.2.2 

Rewind Option, No 8.4.7 

Insert (I) Command 4.4.7.2 



Keep (K) Command 4.4.9.1 

Keyboard: 

Commands, TXDBUG T9-2 

Control Keys, Special 2.3.3 

Keys: 

Special 4.4.4 

Keyboard Control 2.3.3 

Limits (L) Command 4.4.8.1 

Lines Option, Number 8.4.6 

Link: 

Editor 7.1 

Utility Program., TXDS 7.1 

Linking Object Modules Section VII 

List File Option 8.4.4 

Listing Option: 

Space 8.4.5 

Symbol Table 5.4.5 

Load: 

Map Option 7.4.5 

Option 11.3.3.2 

LUNO Utility 13.1 

Map Option, Load 7.4.5 

Memory Display Parameter 10.7.5 

Memory Level N Bit Step 10.7.14 

Memory Level N Loop Count 

Parameter 10.7.5 

Memory Mapping Levels Parameter. . . 10.7.13 
Memory: 

Option (M) 5.4.1 

Override 7.4.1 

Memory Starting Address Parameter . . . 10.7.7 

Memory Starting Bit 10.7.9 

Messages: 

BNPFHL Error Tll-1 

IBMUTL Error T12-1 

TXDBUG Error 9.8 

TXDS Control Program Error T2-3 

TXEDIT Error T4-3 

TXLINK Error T7-3 

TXLUNO Error 13.4 

TXMIRA Error 5.5.1 

TXPROM, Error 10.13 

TXXREF Error T6-2 

Mode: 

Execute Free 9.4 

Run 9.4 

Modes, Debug 9.4 

Modification, Control File 10.5.2 

Modules, Linking Object Section VII 

Move (M) Command 4.4.7.3 

Name: 

Device 2.3.1 

File 2.3.1 

Volume 2.3.1 

No: 

Input Rewind Option 8.4.7 

Output Rewind Option 8.4.8 

Nonfatal Errors, TXMIRA T5-5 
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Number Lines Option 

Number of PROM Words . . 
Number of Retries Parameter 



. 8.4.6 
10.7. II 
10.7.24 



Object: 
Code 

Format I I.I 

Format, Compressed Appendix B 

Modules, Linking Section VII 

Option: 

Compressed 7.4.2 

Compressed 5.4.6 

Operands, Commands 4.4.2 

Option: 

Bias 1 1.3.3.3 

BNPF HILO 11.3.3.1 

Compare 1 1.3.3.2 

Compressed Object 5.4.6, 7.4.2 

Cross-Reference 5.4.2 

Dump 1 1.3.3.2 

Initialization 11.3.3.4 

List File 8.4.4 

Load 11.3.3.2 

Map 7.4.5 

Memory 5.4.1 

No 

Input Rewind 8.4.7 

Output Rewind 8.4.8 

Number Lines 8.4.6 

Partial 7.4.4 

Position 1 1.3.3.5 

Predefine Registers 5.4.7 

Print Text 5.4.4 

Program Identifier 7.4.3 

Skip Record 8.4.3 

Space Listing 8.4.5 

Symbol Table Listing 5.4.5 

Truncate , 8.4.1 

Options: 

Prompt 2.3.2.4 

TXCCAT T8-2 

TXLINK T7-2 

Control 7.4 

TXMIRA T5-2, 5.4 

Output: 

Prompt 2.3.2.3 

Rewind Option, No 8.4.8 

Override, Memory 7.4.1 

Parameter: 

Compare After 10.7.4 

CRU Base 10.7.26 

Data Bias 10.7.2 

Duty Cycle 10.7.23 

Memory Display 10.7.5 

Memory Level N Loop Count 10.7.15 

Memory Mapping Levels 10.7.13 

Memory Starting Address 10.7.7 

Number of Retries 10.7.24 

Program Zero or Ones 10.7.21 



PROM: 

Bits Per Word 10.7.20 

Display 10.7.6 

Level N Loop Count I0.7.I8 

Mapping Levels 10.7.16 

Starting Address 10.7.10 

Simutaneously Programmable Bits . 10.7.25 

Transfer Code 10.7.3 

Transfer Bit Width 10.7.19 

Prompts, Control File TIO-I 

Partial Option 7.4.4 

Patching 9.7.3 

Pathname 2.3.1 

Defaults T5-L T6-I, T7-1, T8-I 

Syntax Variations T2-1 

Position Option 1 1.3.3.5 

Predefine Registers OpUon 5.4.7 

Preventive Techniques 9.7 

Print Command 4.4.8.2 

Print Margin Command 4.4.5.3 

Print Text Option 5.4.4 

Program: 

Error Messages, TXDS Control T2-3 

Filename Identifiers, Utility T2-2 

Identifier Option 7.4.3 

Prompt 2.3.2.1 

TXPROM Utility 10.1 

TXDBUG Utility Section IX 

TXDS: 

Control 1.1, 2.1 

Copy/ Concentrate Utility . . . Section VI II 

Cross-Reference Utility Section VI 

Link Utility 7.1 

TXEDIT Utility Section IV 

TXMIRA Utility 5.1 

Program Zero or Ones Parameter 10.7.21 

Programs, Assembling Source Section V 

PROM: 

Bits Per Word Parameter 10.7.20 

Display Parameter 10.7.6 

Level N Bit Step 10.7.17 

Level N Loop Count Parameter .... 10.7.18 

Mapping Levels Parameter 10.7.16 

Starting: 

Address Parameter 10.7.10 

Bit 10.7.12 

Prompt: 

Input 2.3.2.2 

Options 2.3.2.4 

Output 2.3.2.3 

Program 2.3.2.1 

Prompts, Control File Parameter TlO-1 

Pulse Width Parameter 10.7.22 

Quit (0) Command 4.4.9.2 

Record Option Skips, Skip 8.4.3 

Records, Fix 8.4.2 

Region, Iracc 9.5 

Registers Option, Predefined 5.4.7 

Remedial Techniques 9.7 

Remove (R) Command 4.4.7.4 
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Rewind Option: 

No Input 8.4.7 

No Output 8.4.8 

RU Command 9.6.2 

Run Mode 9.4 

Scratch File 4.1 

Set Margin (SM) Command 4.4.5.4 

Simultaneously Programmable Bits 

Parameter 10.7.25 

Skip Record Option 8.4.3 

Snapshot 9.5 

Source Programs, Assembling Section V 

Space Listing Option 8.4.5 

Special: 

Characters 12.5.1, 13.2.2 

Keyboard Control Keys 2.3.3 

Keys 4.4.4 

Standalone 9. 1 

Standard Control Files 10.9 

Start Line Numbers (SL) Command . . 4.4.5.1 

State Codes, Task Appendix C 

Stop Numbers (SN) Command 4.4.5.2 

Symbol Table Listing Option 5.4.5 

Syntax Variations, Pathname T2-1 

System Console 1.1 

Task State Codes Appendix C 

Techniques: 

Debugging 9.7 

Exposure 9.7 

Preventive 9.7 

Remedial 9.7 

Text Option, Print 5.4.4 

Top (T) Command 4.4.6.3 

Trace: 

Formats 9.6.12.1 

Region 9.5 

Transfer Code Parameter 10.7.3 

Transfer Bit Width Parameter 10.7.19 

Truncate Option 8.4.1 

TXPROM Utility Program 10.1 

TXCCAT 8.1 

Errors T8-3 

Options T8-2 



TXDBUG: 

Error Messages 9.8 

Keyboard Commands T9-2 

Utility Program Section IX 

TXDS: 

Control Program I.I, 2.1 

Error Messages T2-3 

Copy/ Concentrate Utility 

Program Section VIII 

Cross-Reference Utility 

Program Section VI 

Link Utility Program 7.1 

TXEDIT: 

Commands 4.1 

Error Messages T4-3 

Utility Program Section IV 

TXLINK 7.1 

Control Options 7.4 

Error Messages T7-3 

Options T7-2 

TXLUNO, Error Messages 13.4 

TXMIRA: 

Error Messages 5.5.1 

Fatal Errors T5-4 

Nonfatal Errors T5-5 

Options 5-2, 5.4 

Utility Program 5.1 

TXPROM, Error Messages 10.13 

TXXREF Error Messages T6-2 

Up (UP) Command 4.4.6.2 

Utility: 

LUNO 13.1 

Program 

Filename Identifiers T2-2 

TXPROM 10.1 

TXDBUG Section IX 

TXDS Copy/ Concentrate . . Section VIII 

TXDS Cross-Reference Section VI 

TXDS Link 7.1 

TXEDIT Section IV 

TXMIRA 5.1 

Value, Defauh 2.3.1 

Variations, Pathname Syntax T2-1 

Volume Name 2.3.1 
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USER'S RESPONSE SHEET 



Manual TjtU' Model 990 Computer Terminal Executive Development 
System (TXDS) Programmer's Guide (946258-9701) 



Manual ^?t^ 15 December 1977 

User's Name: 

Company : 



Date of This Letter: 
Telephone : 



Office/Department :. 



Street Address:. 



City /State/Zip Code: 



Please list any discrepancy found in this manual by page, paragraph, figure, or table number in 
the following space. If there are any other suggestions that you wish to make, feel free to 
include them. Thank you. 



Location in Manual 



Comment/Suggestion 
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